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WARNING! This is a translated version of the English Hibernate reference 
documentation. The translated version might not be up to date! However, the 
differences should only be very minor. Consult the English reference 
documentation if you are missing information or encounter a translation error. If 
you like to contribute to a particular translation, contact us on the Hibernate 
developer mailing list. 


Translator(s): RedSaga Translate Team 满江红 翻译 团队 <caoxg@yahoo.com> 


在 今日 的 企业 环境 中 ， 把 面向 对 象 的 软件 和 关系 数据 库 一 起 使 用 可 能 是 相当 麻烦 、 
浪费 时 间 的 。Hibernate 是 一 个 面向 Java 环 境 的 对 象 /关系 数据 库 映 射 工具 。 对 象 / 关 
系数 据 库 映射 (objectrelational mapping (ORM)) 这 个 术语 表示 一 种 技术 ， 用 来 把 对 
象 模型 表示 的 对 象 映射 到 基于 SQL 的 关系 模型 数据 结构 中 去 。 


Hibernate 不 仅仅 管理 Java 类 到 数据 库 表 的 映射 (包括 Java 数 据 类 型 到 SQL 数 据 类 
型 的 映射 ) ， 还 提供 数据 查询 和 获取 数据 的 方法 ， 可 以 大 幅度 减少 开发 时 人 工 使 用 
SQL 和 JDBC 义 理 数据 的 时 间 。 


Hibernate 的 目标 是 对 于 开发 者 通常 的 数据 持久 化 相关 的 编程 任务 ， 解 放 其 中 的 
95%。 对 于 以 数据 为 中 心 的 程序 来 说 ,它们 往往 只 在 数据 库 中 使 用 存储 过 程 来 实现 商 
业 逻 和 辑 ,Hibernate 可 能 不 是 最 好 的 解决 方案 ;对 于 那些 在 基于 Java 的 中 间 层 应 用 中 ， 
它们 实现 面向 对 象 的 业务 模型 和 商业 逻辑 的 应 用 ，Hibernate 是 最 有 用 的 。 不 管 怎 
样 ，Hibernate 一 定 可 以 帮助 你 消除 或 者 包装 那些 针对 特定 厂商 的 SQL 代码 ， 并 且 帮 
你 把 结果 集 从 表格 式 的 表示 形式 转换 到 一 系列 的 对 象 去 。 


如 果 你 对 Hibernate 和 对 象 /关系 数据 库 映 射 还 是 个 新 手 ， 或 者 甚至 对 Java 也 不 熟 

悉 ， 请 按照 下 面 的 步骤 来 学 习 。 

1. 阅读 第 1 章 Hibernate 入 门 ， 这 是 一 篇 包含 详细 的 逐步 指导 的 指南 。 本 指南 的 
源 代码 包含 在 发 行 包 中 ， 你 可 以 在 doc/reference/tutorial/ 目录 下 找到 。 

2. 阅读 第 2 章 体系 结构 (Architecture) 来 理解 Hibernate 可 以 使 用 的 环境 。 


3. 查看 Hibernate 发 行 包 中 的 eg/ 目录 ， 里 面 有 一 个 简单 的 独立 运行 的 程序 。 把 
你 的 JDBC 了 驱动 拷贝 到 1ib/ 目录 下 ， 修 改 一 
下 src/hibernate.properties ,指定 其 中 你 的 数据 库 的 信息 。 进 入 命令 行 ， 
切换 到 你 的 发 行 包 的 目录 ， 输 入 ant eg (使 用 了 Ant) ， 或 者 在 Windows 操 作 
系统 中 使 用 build eg 。 


4. 把 这 份 参考 文档 作为 你 学 习 的 主要 信息 来 源 。 
5. 在 Hibernate 的 网 站 上 可 以 找到 经 常 提问 的 问题 与 解答 (FAQ)。 


6. 在 Hibernate 网 站 上 还 有 第 三 方 的 演示 、 示 例 和 教程 的 链接 。 


7. Hibernate 网 站 的 “社区 (Community Areal)" 是 讨论 关于 设计 模式 以 及 很 多 整合 方 
案 (Tomcat, JBoss AS, Struts, EJB, 等 等 ) 的 好 地 方 。 


如 果 你 有 问题 ， 请 使 用 Hibernate 网 站 上 链接 的 用 户 论坛 。 我 们 也 提供 一 个 JIRA 问 
题 追踪 系统 ， 来 搜集 bug 报 告 和 新 功能 请 求 。 如 果 你 对 开发 Hibernate 有 兴趣 ， 请 加 
入 开发 者 的 邮件 列表 。 (Hibernate 网 站 上 的 用 户 论坛 有 一 个 中 文 版 面 ，JavaEye 也 
有 Hibernate 中 文 版 面 ,您 可 以 在 那里 交流 问题 与 经 验 。 ) 


商业 开发 、 产 品 支 持 和 Hibernate 培 训 可 以 通过 JBoss Inc. 获 得 。 (请 查阅 : 
http://www.hibernate.org/SupportTraining/) > Hibernate 是 一 个 专业 的 开放 源 代码 
a H (Professional Open Source project)， 也 是 JBoss Enterprise Middleware 
System(JEMS),JBoss 企 业 级 中 间 件 系统 的 一 个 核心 组 件 。 


1. 翻译 说 明 


本 文档 的 翻译 是 在 网 络 上 协作 进行 的 ， 也 会 不 断根 据 Hibernate 的 升级 进行 更 新 。 提 
供 SERR E T A 2 Hibemate sy iRBE 而 非 代替 原文 档 。 我 们 建议 所 有 
有 能 力 的 读者 都 直接 阅读 英文 原文 。 若 您 对 翻译 有 异议 ， 或 发 现 翻译 错误 ， 敬 请 不 
将 网 教 ， 报 告 到 如 下 email 地 址 : cao at redsaga.com 


Hibernate 版 本 3 的 翻译 由 满江红 翻译 团队 (RedSaga Translate Team) 集 体 进 行 ， 这 
一 次 大 规模 网 络 翻译 的 试验 。 在 不 到 20 天 的 时 间 内 ， 我 们 完成 了 两 百 多 页 文档 
的 翻译 ， 这 一 成 果 是 通过 十 几 位 网 友 集 体 努 力 完成 的 。 通 过 这 次 翻译 ， aan 
一 套 完整 的 流程 ， 从 初 译 、 技 术 审 核 一 直到 文字 审核 、 发 布 。 我 们 的 翻译 团队 还 
继续 完善 我 们 的 翻译 流程 ， 并 翻译 其 他 优秀 的 Java 开 源 资料 ， 敬 请 期 待 。 
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Vv3.2 版 本 在 2006 年 11 月 份 由 曹 晓 钢 更 新 。 
天 于 我 们 
满江红 .开源 , http://www.redsaga.com 


从 成 立 之 初 就 致力 于 Java 开 放 源 代码 在 中 国 的 传播 与 发 展 ,与 国内 多 个 Java 团 体 及 

出 版 社 有 深入 交流 。 坚 持 少 说 多 做 的 原则 ， 目 前 有 两 个 团队 ，“OpenDoc 团 队 " 与 “ 翻 
译 团 队 ”， 本 翻译 文档 即 为 翻译 团队 作品 。OpenDoc 团 队 已 经 推出 包括 Hibernate、 

iBatis、Spring、WebWork 的 多 份 开放 文档 ， 并 于 2005 年 5 月 在 Hibernate 开 放 文 档 
基础 上 扩充 成 书 ， 出 版 了 原创 书籍 : 《深入 浅 出 Hibernate》， 本 书 400 余 页 ， 适 合 
各 个 层次 的 Hibernate 用 户 。(http://www.redsaga.com/hibernate_book.html) 敬 请 支 
持 。 


北京 Java 用 户 组 , http://www.bjug.org 

Beiing Java User Group， 民 间 技 术 交 流 组 织 ， 成 立 于 2004 年 6 月 。 以 交流 与 共享 为 
宗旨 ， 每 两 周 举 行 一 次 技术 聚会 活动 。BJUG 的 目标 是 ， 通 过 小 部 分 人 的 努力 ， 形 
成 一 个 技术 社 群 ， 创 建 良 好 的 交流 氛围 ， 并 将 新 的 技术 和 思想 推广 到 整个 [TT 界 ， 让 
我 们 共同 进步 。 

Java 视 线 , http://www.javaeye.com 


Java 视 线 在 是 Hibernate 中 文 论坛 ( http://www.hibernate.org.cn ，Hibernate 中 文 
论坛 是 中 国 最 早 的 Hibernate 专 业 用 户 论坛 ， 为 Hibernate 在 中 国 的 推广 做 出 了 巨大 
的 贡献 ) 基础 上 发 展 起 来 的 Java 深 度 技术 网 站 ， 目 标 是 成 为 一 个 高 品质 的 ， 有 思想 
深度 的 、 原 创 精神 的 Java 技 术 交 流 网 站 ， 为 软件 从 业 人 员 提 供 一 个 自由 的 交流 技 


术 ， 交 流 思 想 和 交流 信息 的 平台 。 
致谢 
还 有 一 些 朋 友 给 我 们 发 来 了 勘误 ， 在 此 致谢 : Kurapica， 李 毅 ， 李 海 林 。 


2. 版 权 声 明 


Hibernate 英 文 文档 属于 Hibernate 发 行 包 的 一 部 分 ， 遵 循 LGPL 协 议 。 本 翻译 版 本 同 
样 遵循 LGPL 协 议 。 参 与 翻译 的 译 者 一 致 同意 放弃 除 署名 权 外 对 本 翻译 版 本 的 其 它 
权利 要 求 。 


您 可 以 自由 链接 、 下 载 、 传 播 此 文档 ， 或 者 放置 在 您 的 网 站 上 ， 其 至 作为 产品 的 一 
部 分 发 行 。 但 前 提 是 必须 保证 全 文 完整 转载 ， 包 括 完整 的 版 权 信息 和 作 译 者 声明 ， 
并 不 能 违反 LGPL 协 议 。 这 里 "完整 "的 含义 是 ， 不 能 进行 任何 删除 /增添 /注解 。 若 有 
删除 /增添 注解， 必须 逐 段 明确 声明 那些 部 分 并 非 本 文档 的 一 部 分 。 
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1.1. a 
本 章 是 面向 Hibernate 初 学 者 的 一 个 入 门 教程 。 我 们 从 一 个 使 用 驻 留 内 存 式 (in- 
memory) 数 据 库 的 简单 命令 行 应 用 程序 开始 , 用 易于 理解 的 方式 逐步 开发 。 


本 章 面 向 Hibernate 初 学 者 ， 但 需要 Java 和 SQL 知识 。 它 是 在 Michael Goegl 所 写 的 
指南 的 基础 上 完成 的 。 在 这 里 ， 我 们 称 第 三 方 库 文 件 是 指 JDK 1.4 和 5.0。 若 使 用 
JDK1.3， 你 可 能 需要 其 它 的 库 文件 。 


本 章 的 源 代码 已 包含 在 发 布 包 中 ， 位 于 doc/reference/tutorial/ 目录 下 。 


1.2. 第 一 部 分 一 第 一 个 Hibernate 应 用 程序 


首先 我 们 将 创建 一 个 简单 的 基于 控制 台 的 (console-based)Hibernate 应 用 程序 。 由 
于 我 们 使 用 Java 数 据 库 (HSQL DB)， 所 以 不 必 安 装 任何 数据 库 服务 器 。 


假设 我 们 希望 有 一 个 小 应 用 程序 可 以 保存 我 们 希望 参加 的 活动 (events) 和 这 些 活 
动 主办 方 的 相关 信息 。 ( 译 者 注 : 在 本 教程 的 后 面部 分 ， 我 们 将 直接 使 用 event 而 
不 是 它 的 中 文 翻译 “活动 "以免 混淆 。) 


我 们 所 做 的 第 一 件 事 就 是 创建 我 们 的 开发 目录 ， 并 且 把 所 有 需要 用 到 的 Java 库 文件 
放 进 去 。 解 压缩 从 Hibernate 网 站 下 载 的 Hibernate 发 布 包 ， 并 把 /1ib 目录 下 所 有 
需要 的 库 文 件 拷 到 我 们 新 建 开 发 目录 下 的 /Lib 目录 下 。 看 起 来 就 像 这 样 : 


+lib 
antlr.jar 
cglib.jar 
asm.jar 
asm-attrs.jars 
commons-collections. jar 
commons-logging. jar 
ehcache. jar 
hibernate3. jar 
jta.jar 
dom4j , jar 
log4j.jar 


到 编 守 本 文 时 为 止 ， 这 些 是 Hibernate 运 行 所 需要 的 最 小 库 文件 集合 (注意 我 们 也 拷 
n T Hibernate3.jar， 这 个 是 最 主要 的 文件 ) 。 你 正 使 用 的 Hibernate 版 本 可 能 需 
比 这 更 多 或 少 一 些 的 库 文件 。 请 参见 发 布 包 中 的 1ib/ 目录 下 的 README.txt , 
以 获取 更 多 关于 所 需 和 可 选 的 第 三 方 库 文件 信息 (事实 上 ，Log4j 并 不 是 必须 的 库 
文件 ， 但 被 许多 开发 者 所 喜欢 ) 。 


接 下 来 我 们 创建 一 个 类 ， 用 来 代表 那些 我 们 希望 储存 在 数据 库 里 的 event。 


1.2.1. 第 一 个 class 
我 们 的 第 一 个 持久 化 类 是 一 个 带 有 一 些 属性 (property) 的 简单 JavaBean 类 : 


package events; 
import java.util.Date; 


public class Event { 
private Long id; 


private String title; 
private Date date; 


public Event() {} 


public Long getId() { 
return id; 
} 


private void setId(Long id) { 
this.id = id; 
} 


public Date getDate() { 
return date; 
} 


public void setDate(Date date) { 
this.date = date; 
} 


public String getTitle() { 
return title; 
} 


public void setTitle(String title) { 
this.title = title; 
} 


你 可 以 看 到 这 个 类 对 属性 的 存 取 方 法 (getter and setter method) 使 用 了 标准 
JavaBean 命 名 约定 ， 同 时 把 类 属性 (field) 的 访问 级 别 设 成 私有 的 (private) 。 这 
是 推荐 的 设计 ， 但 并 不 是 必须 的 。Hibernate 也 可 以 直接 访问 这 些 field， 而 使 用 访问 
方法 (accessor method) 的 好 处 是 提供 了 重 构 时 的 健壮 性 (robustness) 。 为 了 
通过 反射 机 制 (Reflection) 来 实例 化 这 个 类 的 对 象 ， 我 们 需要 提供 一 个 无 参 的 构 
造 器 (no-argument constructor), 


对 一 特定 的 event，id 属性 持 有 唯一 的 标识 符 (identifier) 的 值 。 如 果 我 们 希望 使 
用 Hibernate 提 供 的 所 有 特性 ， 那 么 所 有 的 持久 化 实体 (persistent entity) 类 (这 里 
也 包括 一 些 次 要 依赖 类 ) 都 需要 一 个 这 样 的 标识 符 属性 。 而 事实 上 ， 大 多 数 应 用 程 
Fe (特别 是 web 应 用 程序 ) 都 需要 通过 标识 符 来 区 别 对象 ， 所 以 你 应 该 考虑 使 用 标 
识 符 属性 而 不 是 把 它 当 作 一 种 限制 。 然 而 ， 我 们 通常 不 会 操作 对 象 的 标识 
(identity) ， 因 此 它 的 setter 方 法 的 访问 级 别 应 该 声明 private。 这 样 当 对 象 被 保存 
的 时 候 ， 只 有 Hibernate 可 以 为 它 分 配 标识 符 值 。 你 可 看 到 Hibernate 可 以 直接 访问 
public，private 和 protected 的 访问 方法 和 field。 所 以 选择 哪 种 方式 完全 取决 于 你 ， 
你 可 以 使 你 的 选择 与 你 的 应 用 程序 设计 相 吻 合 。 


所 有 的 持久 化 类 (persistent classes) 都 要 求 有 无 参 的 构造 器 ， 因 为 Hibernate 必 须 
使 用 Java 反 射 机 制 来 为 你 创建 对 象 。 构 造 器 (constructor) 的 访问 级 别 可 以 是 
private， 然 而 当 生 成 运行 时 代理 (runtime proxy) 的 时 候 则 要 求 使 用 至 少 是 
package 级 别 的 访问 控制 ， 这 样 在 没有 字 节 码 指令 (bytecode instrumentation) 的 
情况 下 ， 从 持久 化 类 里 获取 数据 会 更 有 效率 。 


把 这 个 Java 源 代码 文件 放 到 开发 目录 下 的 src 目录 里 ， 注 意 包 位 置 要 正确 。 现在 
这 个 目录 看 起 来 应 该 像 这 样 : 


+lib 
<Hibernate and third-party libraries> 
+Src 
+events 
Event , java 


下 一 步 ， 我 们 把 这 个 持久 化 类 的 信息 告诉 Hibernate。 


1.2.2. 映射 文件 


Hibernate 需 要 知道 怎样 去 加 载 (load) 和 存储 (store) 持久 化 类 的 对 象 。 这 正 是 
Hibernate 映 射 文件 发 挥 作 用 的 地 方 。 映 射 文件 告诉 Hibernate 它 ， 应 该 访问 数据 库 
(database) 里 面 的 哪个 表 (table) 及 应 该 使 用 表 里 面 的 哪些 字段 (column) 。 


一 个 映射 文件 的 基本 结构 看 起 来 像 这 样 : 


<?xml version="1.0"?> 

<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dt¢ 


<hibernate-mapping> 


</hibernate-mapping> 





注意 Hibernate 的 DTD 是 非常 复杂 的 。 你 的 编辑 器 或 者 IDE 里 使 用 它 来 自动 完成 那些 
用 来 映射 的 XML 元 素 (element) 和 属性 (attribute) 。 你 也 可 以 在 文本 编辑 器 里 打 
开 DTD 一 这 是 最 简单 的 方式 来 概览 所 有 的 元 素 和 attribute， 并 查看 它们 的 缺 省 值 以 
及 注释 。 注 意 Hibernate 不 会 从 web 加 载 DTD 文 件 ， 但 它 会 首先 在 应 用 程序 的 
classpath 中 查找 。DTD 文 件 已 包括 在 hibernate3,jar 里 ， 同 时 也 在 Hibernate 发 
布 包 的 src/ 目录 下 。 


为 缩短 代码 长 度 ， 在 以 后 的 例子 里 我 们 会 省 略 DTD 的 声明 。 当 然 ， 在 实际 的 应 用 程 
序 中 ，DTD 声 明 是 必须 的 。 


在 hibernate-mapping 标签 (tag) Zi], 含有 一 个 class 元 素 。 所 有 的 持久 化 
实体 类 (再 次 声明 ， 或 许 接 下 来 会 有 依赖 类 ， 就 是 那些 次 要 的 实体 ) 都 需要 一 个 这 
样 的 了 映射， 来 把 类 对 象 映 射 到 SQL 数 据 库 里 的 表 。 


<hibernate-mapping> 
<class name="events.Event" table="EVENTS"> 
</class> 
</hibernate-mapping> 
到 目前 为 止 ， 我 们 告诉 了 Hibernate 怎 样 把 Events 类 的 对 象 持久 化 到 数据 库 
的 EVENTS 表 里 ， 以 及 怎样 从 EVENTS 表 加 载 到 Events 类 的 对 象 。 每 个 实例 对 
应 着 数据 库 表 中 的 一 行 。 现 在 我 们 将 继续 讨论 有 关 唯 一 标识 符 属 性 到 数据 库 表 的 映 


射 。 另 外 ， 由 于 我 们 不 关心 怎样 处 理 这 个 标识 符 ， 我 们 就 配置 由 Hibernate 的 标识 符 
生成 策略 来 产生 代理 主键 字段 。 


<hibernate-mapping> 


<class name="events.Event" table="EVENTS"> 
<id name="id" column="EVENT_ID"> 
<generator class="native"/> 
</id> 
</class> 


</hibernate-mapping> 


id 元 素 是 标识 符 属性 的 声明 ， name="id" 声明 了 Java 属 性 的 名 字 一 Hibernate 
会 使 用 getId() 和 setId() 来 访问 它 。 column 属性 则 告诉 Hibernate, 我 们 使 
用 EVENTS FAVORS ERE A Etto REB generator 元 素 指 定 了 标识 符 生成 策 
略 ， 在 这 里 我 们 指定 native ， 它 根据 已 配置 的 数据 库 (方言 ) 自动 选择 最 佳 的 标 
识 符 生成 策略 。Hibernate 支 持 由 数据 库 生 成 ， 全 局 唯一 性 (globally unique) 和 应 
用 程序 指定 (或 者 你 自己 为 任何 已 有 策略 所 写 的 扩展 ) 这 些 策略 来 生成 标识 符 。 


最 后 我 们 在 映射 文件 里 面包 含 需要 持久 化 属性 的 声明 。 默 认 情 况 下 ， 类 里 面 的 属性 
都 被 视 为 非 持久 化 的 : 


<hibernate-mapping> 


<class name="events.Event" table="EVENTS"> 
<id name="id" column="EVENT_ID"> 
<generator class="native"/> 
</id> 
<property name="date" type="timestamp" column="EVENT_DATE", 
<property name="title"/> 
</class> 


</hibernate-mapping> 


a SS 





和 id 元 素 一 样 ， property 元 素 的 name 属性 告诉 Hibernate 使 用 哪个 getter 和 
setter 方 法 。 在 此 例 中 ，Hibernate 会 寻找 getDate()/setDate() ,以 
及 getTitle()/setTitle() 。 


为 什么 date 属性 的 上 映射 含有 column attribute, m title 却 没有 ?3 当 没 有 设 

Œ column attribute 的 时 候 ，Hibernate 缺 省 地 使 用 JavaBean 的 属性 名 作为 字段 

名 。 对 于 title ， 这 样 工作 得 很 好 。 然 而 ， date 在 多 数 的 数据 库 里 ， 是 一 个 保 
留 关 键 字 ， 所 以 我 们 最 好 把 它 映射 成 一 个 不 同 的 名 字 。 


另 一 有 趣 的 事情 是 title 属性 缺少 一 个 type attribute。 我 们 在 映射 文件 里 声明 
并 使 用 的 类 型 ， 却 不 是 我 们 期 望 的 那样 ， 是 Java 数 据 类 型 ， 同 时 也 不 是 SQL 数据 库 
的 数据 类 型 。 这 些 类 型 就 是 所 谓 的 Hibernate 映射 类 型 (mapping types) ， 它 们 能 
把 Java 数 据 类 型 转换 到 SQL 数据 类 型 ， 反 之 亦 然 。 再 次 重申 ， 如 果 在 映射 文件 中 没 
有 设置 type 属性 的 话 ，Hibernate 会 自己 试 着 去 确定 正确 的 转换 类 型 和 它 的 映射 
类 型 。 在 某 些 情况 下 这 个 自动 检测 机 制 〈 在 Java 类 上 使 用 反射 机 制 ) 不 会 产生 你 所 


期 待 或 需要 的 缺 省 值 。 date 属性 就 是 个 很 好 的 例子 ，Hibernate 无 法 知道 这 个 属 
M ( java.util.Date 类 型 的 ) 应 该 被 映射 成 : SQL date , 3 timestamp , 
还 是 time 字段 。 在 此 例 中 ， 把 这 个 属性 映射 成 timestamp 转换 器 ， 这 样 我 们 
预 留 了 日 期 和 时 间 的 全 部 信息 。 


应 该 把 这 个 映射 文件 保存 为 Event.hbm.xml ， 且 就 在 Event Java 类 的 源 文 件 目 
录 下 。 了 映射 文件 可 随意 地 命名 ， 但 hbm.xml 的 后 级 已 成 为 Hibernate 开 发 者 社区 的 
约定 。 现 在 目录 结构 看 起 来 应 该 像 这 样 : 


+lib 

<Hibernate and third-party libraries> 
+Src 

+events 

Event.java 

Event .hbm. xml 


我 们 继续 进行 Hibernate 的 主要 配置 。 


1.2.3. Hibernate 配 置 


现在 我 们 已 经 有 了 一 个 持久 化 类 和 它 的 映射 文件 ， 该 是 配置 Hibernate 的 时 候 了 上 。 在 
此 之 前 ， 我 们 需要 一 个 数据 库 。 HSQL DB 是 种 基于 Java 的 SQL 数据 库 管 理 系统 
(DBMS) ， 可 以 从 HSQL DB 的 网 站 上 下 载 。 实 际 上 ， 你 只 需 下载 的 包 中 

的 hsqldb.jar 文件 ， 并 把 这 个 文件 放 在 开发 文件 夹 的 1ib/ 目录 下 即 可 。 


在 开发 的 根 目 录 下 创建 一 个 data 目录 一 这 是 HSQL DB 存储 数据 文件 的 地 方 。 此 
时 在 data 目 录 中 运 

行 java -classpath ../lib/hsqldb.jar org.hsqldb.Server 就 可 启动 数据 

库 。 你 可 以 在 log 中 看 到 它 的 和 启动， 及 绑 定 到 TCPHIP 套 结 字 ， 这 正 是 我 们 的 应 用 程 
序 稍 后 会 连接 的 地 方 。 如 果 你 希望 在 本 例 中 运行 一 个 全 新 的 数据 库 ， 就 在 窗口 中 按 
下 CTRL + C 来 关闭 HSQL 数 据 库 ， 并 删除 data/ 目录 下 的 所 有 文件 ， 再 重新 启 
动 HSQL 数 据 库 。 


Hibernate 是 你 的 应 用 程序 里 连接 数据 库 的 那 屋 ， 所 以 它 需 要 连接 用 的 信息 。 连 接 
(connection) 是 通过 一 个 也 由 我 们 配置 的 JDBC 连 接 池 (connection pool) 来 完 
成 的 。Hibernate 的 发 布 包 里 包含 了 许多 开源 的 (open source) 连接 池 ， 但 在 我 们 
例子 中 使 用 Hibernate 内 置 的 连接 池 。 注 意 ， 如 果 你 希望 使 用 一 个 产品 级 
(production-quality) 的 第 三 方 连 接 池 软 件 ， 你 必须 拷贝 所 需 的 库 文件 到 你 的 
classpath 下 ， 并 使 用 不 同 的 连接 池 设 置 。 


为 了 保存 Hibernate 的 配置 ， 我 们 可 以 使 用 一 个 简单 的 hibernate.properties 文 
件 ， 或 者 一 个 稍微 复杂 的 hibernate.cfg.xml ， 甚 至 可 以 完全 使 用 程序 来 配置 
Hibernate。 多 数 用 户 更 喜欢 使 用 XML 配置 文件 : 


<?xml version='1.0' encoding='utf-8'?> 

<!DOCTYPE hibernate-configuration PUBLIC 
"-//Hibernate/Hibernate Configuration DTD 3.0//EN" 
"http://hibernate.sourceforge.net/hibernate-configuration-: 


<hibernate-configuration> 


<session-factory> 


<!-- Database connection settings --> 

<property name="connection.driver_class">org.hsqldb.jdbcDr: 
<property name="connection.url">jdbc:hsqldb:hsql://localho: 
<property name="connection.username">sa</property> 
<property name="connection.password"></property> 

<!-- JDBC connection pool (use the built-in) --> 

<property name="connection.pool_size">1</property> 


<!-- SQL dialect --> 


<property 


name="dialect">org.hibernate.dialect .HSQLDialect:< 


<!-- Enable Hibernate's automatic session context managemer 


<property 


name="Current_session_context_class">thread</pro} 


<!-- Disable the second-level cache --> 


<property 


<!-- Echo 
<property 


<!-- Drop 
<property 


name="cache.provider_class">org.hibernate.cache.\! 


all executed SQL to stdout --> 
name="sShow_sql">true</property> 


and re-create the database schema on startup --> 
name="hbm2dd1.auto">create</property> 


<mapping resource="events/Event.hbm.xm1"/> 


</session-factory> 


</hibernate-configuration> 


SSS SSS] 





注意 这 个 XML 配置 使 用 了 一 个 不 同 的 DTD。 在 这 里 ， 我 们 配置 了 Hibernate 

的 SessionFactory 一 一 个 关联 于 特定 数据 库 全 局 的 工厂 (factory) 。 如 果 你 要 
使 用 多 个 数据 库 ， 就 要 用 多 个 的 &1lt;session-factory&gt; ， 通 常 把 它们 放 在 多 
个 配置 文件 中 (为 了 更 容易 启动 ) 。 


最 开始 的 4 个 property 元 素 包 含 必 要 的 JDBC 连 接 信息 。 方 言 (dialect) 
的 property 元 素 指 明 Hibernate 生成 的 特定 SQL 变量 。 你 很 快 会 看 到 ，Hibernate 
对 持久 化 上 下 文 的 自动 Session 管 理 就 会 派 上 用 场 。 打开 hbm2ddl.auto 选项 将 自 


动 生 成 数据 库 模式 (schema) 一 直接 加 入 数据 库 中 。 当 然 这 个 选项 也 可 以 被 关闭 
(通过 去 除 这 个 配置 选项 ) 或 者 通过 Ant 任 务 SchemaExport 的 帮助 来 把 数据 库 
schema 重 定向 到 文件 中 。 最 后 ， 在 配置 中 为 持久 化 类 加 入 映射 文件 。 


把 这 个 文件 拷贝 到 源 代码 目录 下 面 ， 这 样 它 就 位 于 classpath 的 根 目 录 的 最 后 。 
Hibernate 在 和 启动 时 会 自动 在 classpath 的 根 目 录 查 找 名 为 hibernate.cfg.xml 的 
配置 文件 。 


1.2.4. 用 Ant 构 建 


现在 我 们 用 Ant 来 构建 应 用 程序 。 你 必须 先 安 装 Ant 一 可 以 从 Ant 下 载 页 面 得 到 它 。 
怎样 安装 Ant 就 不 在 这 里 介绍 了 ， 请 参考 Ant 用 户 手 册 。 当 你 安装 完了 Ant， 就 可 以 
开始 创建 build.xml 文件 ， 把 它 直 接 放 在 开发 目录 下 面 。 


一 个 简单 的 build 文 件 看 起 来 像 这 样 : 


<project name="hibernate-tutorial" default="compile"> 


<property name="Sourcedir" value="${basedir}/src"/> 
<property name="targetdir" value="${basedir}/bin"/> 
<property name="librarydir" value="${basedir}/lib"/> 


<path id="libraries"> 
<fileset dir="${librarydir}"> 
<include name="*.jar"/> 
</fileset> 
</path> 


<target name="clean"> 
<delete dir="${targetdir}"/> 
<mkdir dir="${targetdir}"/> 
</target> 


<target name="Ccompile" depends="clean, copy-resources"> 
<javac srcdir="${sourcedir }" 
destdir="${targetdir}" 
classpathref="libraries"/> 
</target> 


<target name="Ccopy-resources"> 
<copy todir="${targetdir}"> 
<fileset dir="${sourcedir}"> 
<exclude name="**/*,.java"/> 
</fileset> 
</copy> 
</target> 


</project> 


这 将 告诉 Ant 把 所 有 在 lib 目 录 下 以 .jar 结尾 的 文件 拷贝 到 classpath 中 以 供 编 译 之 
用 。 它 也 把 所 有 的 非 Java 源 代码 文件 ， 例 如 配置 和 Hibernate 映 射 文件 ， 拷 贝 到 目 
标 目录 。 如 果 你 现在 运行 Ant， 会 得 到 以 下 输出 : 


C:\hibernateTutorial\>ant 
Buildfile: build.xml 


copy-resources: 
[copy] Copying 2 files to C:\hibernateTutorial\bin 


compile: 
[javac] Compiling 1 source file to C:\hibernateTutorial\bin 


BUILD SUCCESSFUL 
Total time: 1 second 


1.2.5. 启动 和 辅助 类 


是 时 候 来 加 载 和 储存 一 些 Event 对 象 了 ， 但 首先 我 们 得 编写 一 些 基 础 的 代码 以 完 
成 设置 。 我 们 必须 启动 Hibernate， 此 过 程 包括 创建 一 个 全 局 

的 SessoinFactory ， 并 把 它 储存 在 应 用 程序 代码 容易 访问 的 地 

方 。 SessionFactory 可 以 创建 并 打开 新 的 Session 。 一 个 Session 代表 一 
单线 程 的 单元 操作 ， SessionFactory 则 是 个 线程 安全 的 全 局 对 象 ， 只 需要 被 实 
例 化 一 次 。 


我 们 将 创建 一 个 Hibernateutil 辅助 类 (helper class) 来 负责 启动 Hibernate 和 
更 方便 地 操作 SessionFactory 。 让 我 们 来 看 一 下 它 的 实现 : 


package util; 


import org.hibernate.*; 
import org.hibernate.cfg.*; 


public class HibernateUtil { 
private static final SessionFactory sessionFactory; 


static { 

try { 
// Create the SessionFactory from hibernate.cfg.xml 
sessionFactory = new Configuration().configure().builds 

} catch (Throwable ex) { 
// Make sure you log the exception, as it might be swai 
System.err.println("Initial SessionFactory creation fa: 
throw new ExceptionInInitializerError(ex); 


} 


public static SessionFactory getSessionFactory() { 
return sessionFactory; 





这 个 类 不 但 在 它 的 静态 初始 化 过 程 ( 仅 当 加 载 这 个 类 的 时 候 被 JVM 执 行 一 次 ) 中 产 
生 全 局 的 SessionFactory ， 而 且 隐 藏 了 它 使 用 了 静态 singleton 的 事实 。 它 也 可 
能 在 应 用 程序 服务 器 中 的 JNDI 查 找 SessionFactory o 


如 果 你 在 配置 文件 中 给 SessionFactory 一 个 名 字 ， 在 SessionFactory 创建 
后 ，Hibernate 会 试 着 把 它 绑 定 到 JNDI。 要 完全 避免 这 样 的 代码 ， 你 也 可 以 使 用 
JMX 部 署 ， 让 具有 JMX 角 o 化 HibernateService 并 把 它 绑 定 到 
JNDI。 这 些 高 级 可 选项 在 后 面 的 章节 中 会 讨论 到 。 


把 HibernateUtil.java 放 在 开发 目录 的 源 代码 路 径 下 ， 与 放 events NAH 
All : 


+lib 
<Hibernate and third-party libraries> 
+Src 
+events 
Event.java 
Event .hbm. xml 
+Util 
HibernateUtil.java 
hibernate.cfg.xml 
+data 
build.xml 


再 次 编译 这 个 应 用 程序 应 该 不 会 有 问题 。 最 后 我 们 需要 配置 一 个 日 志 (logging)* 
统 一 Hibernate 使 用 通用 日 志 接 口 ， 人 允许 你 在 Log4j 和 JDK 1.4 日 志 之 间 进 行 选择 。 
多 数 开 发 者 更 喜欢 Log4j : 从 Hibernate 的 发 布 包 中 (CH etc/ 目录 下 ) # 

贝 log4j.properties 到 你 的 src 目录 ， 与 hibernate.cfg.xml . 放 在 一 起 。 
看 一 下 配置 示例 ， 如 果 你 希望 看 到 更 加 详细 的 输出 信息 ， 你 可 以 修改 配置 。 默 认 情 
况 下 ， 只 有 Hibernate 的 启动 信息 才 会 显示 在 标准 输出 上 。 


示例 的 基本 框架 完成 了 一 现在 我 们 可 以 用 Hibernate 来 做 些 真 正 的 工作 。 


1.2.6. 加 载 并 存储 对 象 


我 们 终于 可 以 使 用 Hibernate 来 加 载 和 存储 对 象 了 ， 编 写 一 个 带 有 main() 方法 


的 EventManager 类 : 


package events; 
import org.hibernate.Session; 


import java.util.Date; 
import util.HibernateUtil; 
public class EventManager { 


public static void main(String[] args) { 
EventManager mgr = new EventManager(); 


if (args[0].equals("store")) { 


mgr .createAndStoreEvent("My Event", new Date()); 
} 


HibernateUtil.getSessionFactory().close(); 


} 

private void createAndStoreEvent(String title, Date theDate) { 
Session session = HibernateUtil.getSessionFactory().getCuri 
session.beginTransaction(); 
Event theEvent = new Event(); 
theEvent.setTitle(title); 
theEvent.setDate(theDate); 


session.save(theEvent); 


session.getTransaction().commit(); 





我 们 创建 了 个 新 的 Event 对 象 并 把 它 传 递 给 Hibernate。 现 在 Hibernate 负 责 与 
SQL 打交道 ， 并 把 INSERT 命令 传 给 数据 库 。 在 运行 之 前 ， 让 我 们 看 一 下 义 
理 Session 和 Transaction 的 代码 。 


一 个 Session 就 是 个 单一 的 工作 单元 。 我 们 暂时 让 事情 简单 一 些 ， 并 假设 
Hibernate Session 和 数据 库 事 务 是 一 一 对 应 的 。 为 了 让 我 们 的 代码 从 底层 的 事务 
系统 中 脱离 出 来 (此 例 中 是 JDBC， 但 也 可 能 是 JTA) ， 我 们 使 用 Hibernate 


Session 中 的 Transaction API。 


sessionFactory.getcurrentSession() 是 干什么 的 呢 ? 首先， 只 要 你 持 

有 SessionFactory (幸亏 我 们 有 HibernateUtil ， 可 以 随时 获得 ) ， 大 可 在 
任何 时 候 、 任 何 地 点 调用 这 个 方法 。 getcurrentsession() 方法 总 会 返回 “当前 
的 "工作 单元 。 记 得 我 们 在 hibernate.cfg.xml 中 把 这 一 配置 选项 调整 

为 "thread" 了 吗 ? 因此 ， 因 此 ， 当 前 工作 单元 被 绑 定 到 当前 执行 我 们 应 用 程序 的 
Java 线 程 。 但 是 ， 这 并 非 是 完全 准确 的 ,你 还 得 考虑 工作 单元 的 生命 周期 范围 
(scope), 它 何 时 开始 ,又 何 时 结束 . 


Session 在 第 一 次 被 使 用 的 时 候 , 即 第 一 次 调用 getCurrentSession() 的 时 候 ， 
其 生命 周期 就 开始 。 然 后 它 被 Hibernate 绑 定 到 当前 线程 。 当 事务 结束 的 时 候 ， 不 管 
是 提交 还 是 回 滚 ，Hibernate 会 自动 把 session 从 当前 线程 剥离 ， 并 且 关 闭 它 。 假 
若 你 再 次 调用 getCurrentSession() ， 你 会 得 到 一 个 新 的 Session ， 并 且 开 始 
一 个 新 的 工作 单元 。 这 种 线程 绑 定 (thread-bounq) 的 编程 模型 (model) 是 使 用 
Hibernate 的 最 广泛 的 方式 ,因为 它 支 持 对 你 的 代码 灵活 分 层 ( 事 务 划 分 可 以 和 你 的 数 
据 访 问 代 码 分 离开 来 ,在 本 教程 的 后 面部 分 就 会 这 么 做 )。 


和 工作 单元 的 生命 周期 这 个 话题 相关 ，Hibernate Session 是 否 被 应 该 用 来 执行 
多 次 数据 库 操 作 ?上面 的 例子 对 每 一 次 操作 使 用 了 一 个 Session ， 这 完全 是 巧 
合 ， 这 个 例子 不 是 很 复杂 ， 无 法 展示 其 他 方式 。Hibernate Session 的 生命 周期 
可 以 很 灵活 ， 但 是 你 绝 不 要 把 你 的 上 应用 程序 设计 成 为 每 一 次 数据 库 操 作 都 用 一 个 新 
的 Hibernate Session 。 因 此 就 算 下 面 的 例子 〈 它 们 都 很 简单 ) 中 你 可 以 看 到 这 
种 用 法 ， 记 住 每 次 操作 一 个 session 是 一 个 反 模 式 。 在 本 教程 的 后 面 会 展示 一 个 真正 
的 (web) 程 序 。 


关于 事务 处 理 及 事务 边界 界定 的 详细 信息 ， 请 人 参看 第 11 章 事务 和 并 发 。 在 上 面 的 
例子 中 ， 我 们 也 忽略 了 所 有 的 错误 与 回 滚 的 处 理 。 


为 第 一 次 运行 我 们 的 程序 ， 我 们 得 在 Ant 的 build 文 件 中 增加 一 个 可 以 调用 得 到 的 
target。 


<target name="run" depends="compile"> 
<java fork="true" classname="events.EventManager" classpathref: 
<classpath path="${targetdir}"/> 
<arg value="${action}"/> 
</java> 
</target> 


Ki — R 


action 参数 (argument) 的 值 是 通过 命令 行 调用 这 个 target 的 时 候 设 置 的 : 





C:\hibernateTutorial\>ant run -Daction=store 


你 应 该 会 看 到 ， 编 译 以 后 ，Hibernate 根 据 你 的 配置 启动 ， 并 产生 一 大 堆 的 输出 日 
志 。 在 日 志 最 后 你 会 看 到 下 面 这 行 : 


[java] Hibernate: insert into EVENTS (EVENT_DATE, title, EVENT_ID) 
‘| «Eg Z>] 








这 是 Hibernate 执 行 的 INSERT 命令 ， 问 号 代表 JDBC 的 绑 定 参数 。 如 果 想 要 看 到 绑 
定 参 数 的 值 或 者 减少 日 志 的 长 度 ， 就 要 调整 你 在 1og4j .properties 文件 里 的 设 
E., 


我 们 想 要 列 出 所 有 已 经 被 存储 的 events， 就 要 增加 一 个 条 件 分 支 选 项 到 main 方 法 中 


o 


if (args[0].equals("store")) { 
mgr .createAndStoreEvent("My Event", new Date()); 


} 
else if (args[0].equals("list")) { 
List events = mgr.listEvents(); 
for (int i = 0; i < events.size(); i++) { 
Event theEvent = (Event) events.get(i); 


System.out.println("Event: " + theEvent.getTitle() + 
" Time: " + theEvent.getDate()); 


我 们 也 增加 一 个 新 的 listEvents() 方法 : 
private List listEvents() { 
Session session = HibernateUtil.getSessionFactory().getCurrents 
session. beginTransaction(); 
List result = session.createQuery("from Event").list(); 
session.getTransaction().commit(); 


return result; 





我 们 在 这 里 是 用 一 个 HQL (Hibernate Query Language 一 Hibernate 查 询 语言 ) & 
询 语句 来 从 数据 库 中 加 载 所 有 存在 的 Event 对 象 。Hibernate 会 生成 适当 的 SQL， 
把 它 发 送 到 数据 库 ， 并 操作 从 查询 得 到 数据 的 Event 对 象 。 当 然 ， 你 可 以 使 用 
HQL 来 创建 更 加 复杂 的 查询 。 


现在 ， 根 据 以 下 步骤 来 执行 并 测试 以 上 各 项 : 


e 运行 ant run -Daction=store 来 保存 一 些 内 容 到 数据 库 。 当 然 ， 先 得 用 
hbm2ddl 来 生成 数据 库 schema。 


e 现在 把 hibernate.cfg.xml 文件 中 hbm2ddl 属 性 注释 掉 ， 这 样 我 们 就 取消 了 
在 启动 时 用 hbm2ddl 来 生成 数据 库 schema。 通常 只 有 在 不 断 重 复 进 行 单元 测试 
的 时 候 才 需要 打开 它 ， 但 再 次 运行 hbm2ddlI 会 把 你 保存 的 一 切 都 删 掉 (drop) 

create 配置 的 真实 含义 是 : “在 创建 SessionFactory 的 时 候 ， 从 schema 

Adrop 掉 所 有 的 表 ， 再 重新 创建 它们 ”。 


如 果 你 现在 使 用 命令 行 参数 -Daction=list 运行 Ant， 你 会 看 到 那些 至 今 为 止 我 
们 所 储存 的 events。 当 然 ， 你 也 可 以 多 调用 几 次 store 以 保存 更 多 的 envents。 


注意 ， 很 多 Hibernate 新 手 在 这 一 步 会 失败 ， 我 们 不 时 看 到 关于 Table not found 错 误 
信息 的 提问 。 但 是 ， 只 要 你 根据 上 面 描 述 的 步骤 来 执行 ， 就 不 会 有 这 个 问题 ， 因 为 
hbm2ddl 会 在 第 一 次 运行 的 时 候 创 建 数据 库 sSchema， 后 继 的 应 用 程序 重 起 后 还 能 继 
续 使 用 这 个 schema。 假 若 你 修改 了 映射 ， 或 者 修改 了 数据 库 schema， 你 必须 把 
hbm2ddl 重 新 打开 一 次 。 





1.3. 第 二 部 分 一 天 联 映射 


我 们 已 经 映射 了 一 个 持久 化 实体 类 到 表 上 。 让 我 们 在 这 个 基础 上 增加 一 些 类 之 间 的 
关联 。 首 先 我 们 往 应 用 程序 里 增加 人 (people) 的 概念 ， 并 存储 他 们 所 参与 的 一 个 
Event 列 表 。 ( 译 者 注 : 与 Event 一 样 ， 我 们 在 后 面 将 直接 使 用 person 来 表示 “人 ”而 
不 是 它 的 中 文 翻译 ) 


1.3.1. 映射 Person 关 
最 初 简单 的 Person 类 : 


package events; 
public class Person { 


private Long id; 
private int age; 
private String firstname; 
private String lastname; 


public Person() {} 


// Accessor methods for all properties, private setter for ‘id 


} 
4] RR 
创建 一 个 名 为 Person.hbm.xml 的 新 映射 文件 ( 别 忘 了 最 上 面 的 DTD 引 用 ) 


<hibernate-mapping> 


<class name="events.Person" table="PERSON"> 
<id name="id" column="PERSON_ID"> 
<generator class="native"/> 
</id> 
<property name="age"/> 
<property name="firstname"/> 
<property name="lastname"/> 
</class> 


</hibernate-mapping> 


最 后 ， 把 新 的 映射 加 入 到 Hibernate 的 配置 中 : 


<mapping resource="events/Event.hbm. xm1"/> 
<mapping resource="events/Person.hbm. xm1"/> 


现在 我 们 在 这 两 个 实体 之 间 创 建 一 个 关联 。 显 然 ，persons 可 以 参与 一 系列 
events， 而 events 也 有 不 同 的 参加 者 (persons) 。 我 们 需要 义理 的 设计 问题 是 关 
联 方向 (directionality) ， 阶 数 (multiplicity) 和 集合 (collection) 的 行为 。 


1.3.2. 单 向 Set-based 的 关联 


我 们 将 向 Person 类 增加 一 连 串 的 events。 那 样 ， 通 过 调 

用 aPerson.getEvents() ， 就 可 以 轻松 地 导航 到 特定 person 所 参与 的 events， 而 
不 用 去 执行 一 个 显 式 的 查询 。 我 们 使 用 Java 的 集合 类 (collection) : Set ， 因 为 
set 不 包含 重复 的 元 素 及 与 我 们 无 关 的 排序 。 


我 们 需要 用 set 实现 一 个 单 向 多 值 关 联 。 让 我 们 在 Java 类 里 为 这 个 关联 编码 ， 接 着 
ARETE : 


public class Person { 
private Set events = new HashSet(); 


public Set getEvents() { 
return events; 


} 


public void setEvents(Set events) { 
this.events = events; 


} 


在 映射 这 个 关联 之 前 ， 先 考虑 一 下 此 关联 的 另外 一 端 。 很 显然 ， 我 们 可 以 保持 这 个 
关联 是 单 向 的 。 或 者 ， 我 们 可 以 在 Event 里 创建 另外 一 个 集合 ， 如 果 希 望 能 够 双 
向 地 导航 ， 如 : anEvent.getParticipants() 。 从 功能 的 角度 来 说 ， 这 并 不 是 
必须 的 。 因 为 你 总 可 以 显 式 地 执行 一 个 查询 ， 以 获得 某 个 特定 event 的 所 有 参与 
者 。 这 是 个 在 设计 时 需要 做 出 的 选择 ， 完 全 由 你 来 决定 ， 但 此 讨论 中 关于 关联 的 阶 
数 是 清楚 的 : 即 两 端 都 是 “多 ” 值 的 ， 我 们 把 它 叫 做 多 对 多 (many-to-many) 关 联 。 
而 ， 我 们 使 用 Hibernate 的 多 对 多 映射 : 


<class name="events.Person" table="PERSON"> 
<id name="id" column="PERSON_ID"> 
<generator class="native"/> 
</id> 
<property name="age"/> 
<property name="firstname"/> 
<property name="lastname"/> 


<set name="events" table="PERSON_EVENT"> 
<key column="PERSON_ID"/> 
<many-to-many column="EVENT_ID" class="events.Event"/> 


</set> 


</class> 


Hibernate 支 持 各 种 各 样 的 集合 映射 ， &1t;set&gt; 使 用 的 最 为 普通。 对 于 多 对 多 

关联 (或 叫 n:m 实 体 关 系 ) ,需要 一 个 关联 表 (association table) 。 表 里 面 的 每 

一 行 代表 从 person 到 event 的 一 个 关联 。 表 名 是 由 set 元 素 的 table 属性 配置 

的 。 关 联 里 面 的 标识 符 字段 名 ， 对 于 person 的 一 端 ， 是 由 &1t;key&gt; TRE 

义 ， 而 event 一 端的 字段 名 是 由 &lt;many-to-many&gt; 元 素 的 column 属性 定 

ie Dai 
一 端的 类 ) 。 


因而 这 个 映射 的 数据 库 schema 是 : 


























| | | | 
| EVENTS | | PERSON_EVENT | | | 
| | | | | PERSON | 
| | | | | | 
| *EVENT_ID | <--> | *EVENT_ID | | | 
| EVENT_DATE | | *PERSON_ID | <--> | *PERSON_ID | 
| TITLE | | | | AGE | 
| | | FIRSTNAME | 
| LASTNAME | 
| | 





1.3.3. 使 关联 工作 
我 们 把 一 些 people 和 events 一 起 放 到 EventManager 的 新 方法 中 : 


private void addPersonToEvent(Long personId，Long eventId) { 


Session session = HibernateUtil.getSessionFactory().getCurrents 
session. beginTransaction(); 


Person aPerson = (Person) session.load(Person.class, personId), 
Event anEvent = (Event) session.load(Event.class, eventId); 


aPerson.getEvents().add(anEvent) ; 


session.getTransaction().commit(); 





在 加 载 一 Person 和 Event 后 ， 使 用 普通 的 集合 方法 就 可 容易 地 修改 我 们 定义 的 
集合 。 如 你 所 见 ， 没 有 显 式 的 update() 或 save() ，Hibernate 会 自动 检测 到 集 
合 已 经 被 修改 并 需要 更 新 回 数据 库 。 这 叫做 自动 脏 检 查 (automatic dirty 
checking) ， 你 也 可 以 尝试 修改 任何 对 象 的 hame 或 者 date 属 性 ， 只 要 他 们 处 于 持久 
化 状态 ， 也 就 是 被 绑 定 到 某 个 Hibernate 的 Session 上 (如 : 他 们 刚刚 在 一 个 单 
元 操作 被 加 载 或 者 保存 ) ，Hibernate 监 视 任 何 改变 并 在 后 台 隐 式 写 的 方式 执行 
SQL。 同 步 内 存 状态 和 数据 库 的 过 程 ， 通 常 只 在 单元 操作 结束 的 时 候 发 生 ， 称 此 过 
程 为 清理 缓存 (flushing) 。 在 我 们 的 代码 中 ， 工 作 单 元 由 数据 库 事 务 的 提交 (或 
者 回 滚 ) 来 结束 一 一 这 是 由 CurrentSessionContext 类 的 thread 配置 选项 定 
义 的 。 


当然 ， 你 也 可 以 在 不 同 的 单元 操作 里 面 加 载 person 和 event。 或 在 Session 以 外 修 
改 不 是 处 在 持久 化 (persistent) 状态 下 的 对 象 (如果 该 对 象 以 前 便 经 被 持久 化 ， 那 
么 我 们 称 这 个 状态 为 脱 管 (detached) ) 。 你 其 至 可 以 在 一 个 集合 被 脱 管 时 修改 
它 : 


private void addPersonToEvent(Long personId, Long eventId) { 


Session session = HibernateUtil.getSessionFactory().getCurrents 
session. beginTransaction(); 


Person aPerson = (Person) session 
.createQuery("select p from Person p left join fetch p 
.setParameter("pid", personId) 
.uniqueResult(); // Eager fetch the collection so we cé 
Event anEvent = (Event) session.load(Event.class, eventId); 
session.getTransaction().commit(); 
// End of first unit of work 
aPerson.getEvents().add(anEvent); // aPerson (and its collectic 


// Begin second unit of work 


Session session2 = HibernateUtil.getSessionFactory().getCurrent 
session2.beginTransaction(); 


session2.update(aPerson); // Reattachment of aPerson 


session2.getTransaction().commit(); 





| = a 


xt update 的 调用 使 一 个 脱 管 对 象 重新 持久 化 ， 你 可 以 说 它 被 绑 定 到 一 个 新 的 单元 
操作 上 ， 所 以 在 脱 管状 态 下 对 它 所 做 的 任何 修改 都 会 被 保存 到 数据 库 里 。 这 也 包括 
你 对 这 个 实体 对 象 的 集合 所 作 的 任何 改动 〈 增 加 /删除 ) 。 


这 对 我 们 当前 的 情形 不 是 很 有 用 ， 但 它 是 非常 重要 的 概念 ， 你 可 以 把 它 融 和 人 到 你 自 
己 的 应 用 程序 设计 中 。 在 EventManager 的 main 方 法 中 添加 一 个 新 的 动作 ， 并 从 
命令 行 运行 它 来 完成 我 们 所 做 的 练习 。 如 果 你 需要 person 及 event 的 标识 符 就 
用 save() 方法 返回 它 〈 你 可 能 需要 修改 前 面 的 一 些 方 法 来 返回 那个 标识 符 ) 





else if (args[0].equals("addpersontoevent")) { 
Long eventId = mgr.createAndStoreEvent("My Event", new Date()), 
Long personId = mgr.createAndStorePerson("Foo", "Bar"); 
mgr .addPersonToEvent(personid, eventId); 
System.out.println("Added person " + personId + " to event " + 





上 面 是 个 关于 两 个 同等 重要 的 实体 类 间 关 联 的 例子 。 像 前 面 所 提 到 的 那样 ， 在 特定 
的 模型 中 也 存在 其 它 的 类 和 类 型 ， 这 些 类 和 类 型 通常 是 “次 要 的 "。 你 已 看 到 过 其 中 
的 一 些 ， 像 int 或 String 。 我 们 称 这 些 类 为 值 类 型 (value type) ， 它 们 的 实 





例 依 赖 (qdepend) 在 某 个 特定 的 实体 上 。 这 些 类 型 的 实例 没有 它们 自己 的 标识 
(identity) ， 也 不 能 在 实体 间 被 共享 (比如 ， 两 个 person 不 能 引用 同一 

个 firstname 对 象 ， 即 使 他 们 有 相同 的 first name) 。 当 然 ， 值 类 型 并 不 仅仅 在 
JDK 中 存在 (事实 上 ， 在 一 个 Hibernate 应 用 程序 中 ， 所 有 的 JDK 类 都 被 视 为 值 类 
型 ) ， 而 且 你 也 可 以 编写 你 自己 的 依赖 类 ， 例 如 Address, MonetaryAmount 。 


你 也 可 以 设计 一 个 值 类 型 的 集合 ， 这 在 概念 上 与 引用 其 它 实 体 的 集合 有 很 大 的 不 
同 ， 但 是 在 Java 里 面 看 起 来 几乎 是 一 样 的 。 


1.3.4. 值 类 型 的 集合 


我 们 把 一 个 值 类 型 对 象 的 集合 加 入 Person 实体 中 。 我 们 希望 保存 email 地 址 ， 所 
以 使 用 String 类 型 ， 而 且 这 次 的 集合 类 型 又 是 Set 


private Set emailAddresses = new HashSet(); 


public Set getEmailAddresses() { 
return emailAddresses; 
} 


public void setEmailAddresses(Set emailAddresses) { 
this.emailAddresses = emailAddresses; 
} 


这 个 Set 的 映射 


<Set name="emailAddresses" table="PERSON_EMAIL_ADDR"> 
<key column="PERSON_ID"/> 
<element type="string" column="EMAIL_ADDR"/> 
</set> 


比较 这 次 和 此 前 映射 的 差别 ， 主 要 在 于 element 部 分 ， 这 次 并 没有 包含 对 其 它 实 

体 引 用 的 集合 ， 而 是 元 素 类 型 为 String 的 集合 〈 在 映射 中 使 用 小 宇 的 名 

字 ”string“ 是 向 你 表明 它 是 一 个 Hibernate 的 映射 类 型 或 者 类 型 转换 器 ) 。 和 之 前 一 

样 ， set 元 素 的 table 属性 决定 了 用 于 集合 的 表 名 。 key 元 素 定义 了 在 集合 表 
中 外 键 的 字段 名 。 element 元 素 的 column 属性 定义 用 于 实际 保存 String 值 的 


字段 名 。 


看 一 下 修改 后 的 数据 库 schema。 


























LASTNAME 


| | | | 
| EVENTS | | PERSON_EVENT | | | 
| | | | | PERSON | 
| | | | | | 
| *EVENT_ID | <--> | *EVENT_ID | | | 
| EVENT_DATE | | *PERSON_ID | <--> | *PERSON_ID | <-- 
| TITLE | | | | AGE | 
| | | FIRSTNAME | 
| | 
| | 











你 可 以 看 到 集合 表 的 主键 实际 上 是 个 复合 主键 ， 同 时 使 用 了 2 个 字段 。 这 也 暗示 了 
对 于 同一 个 person 不 能 有 重复 的 email 地 址 ， 这 正 是 Java 里 面 使 用 Set 时 候 所 需要 的 
语义 (Set 里 元 素 不 能 重复 ) 。 


你 现在 可 以 试 着 把 元 素 加 入 到 这 个 集合 ， 就 像 我 们 在 之 前 关联 person 和 event 的 那 
样 。 其 实现 的 Java 代 码 是 相同 的 : 


private void addEmailToPerson(Long personId，String emailAddress) - 


Session session = HibernateUtil.getSessionFactory().getCurrents 
session. beginTransaction(); 


Person aPerson = (Person) session.load(Person.class, personId), 


// The getEmailAddresses() might trigger a lazy load of the co: 
aPerson.getEmailAddresses().add(emailAddress); 


session.getTransaction().commit(); 
} 
这 次 我 们 没有 使 用 felch 查 询 来 初始 化 集合 。 因 此 ， 调 用 其 getter 方 法 会 触发 另 一 附 


加 的 select 来 初始 化 集合 ， 这 桩 我 们 才能 把 元 素 添加 进去 。 检 查 SQL log， 试 着 通过 
预先 抓 取 来 优化 它 。 





1.3.5. 双向 关联 


接 下 来 我 们 将 映射 双向 关联 (bi-directional association) 一 在 Java 里 让 person 和 
event 可 以 从 关联 的 任何 一 端 访问 另 一 端 。 当 然 ， 数 据 库 schema 没 有 改变 ， 我 们 仍 
然 需要 多 对 多 的 阶 数 。 一 个 关系 型 数据 库 要 比 网 络 编程 语言 更 加 灵活 ， 所 以 它 并 不 
需要 任何 像 导 航 方向 (navigation direction) 的 东西 一 数据 可 以 用 任何 可 能 的 方式 
进行 查看 和 获取 。 


首先 ， 把 一 个 参与 者 (person) 的 集合 加 入 Event 类 中 : 


private Set participants = new HashSet(); 


public Set getParticipants() { 
return participants; 


} 


public void setParticipants(Set participants) { 
this.participants = participants; 


} 


在 Event.hbm.xml 里 面 也 映射 这 个 关联 。 


<set name="participants" table="PERSON_EVENT" inverse="true"> 
<key column="EVENT_ID"/> 
<many-to-many column="PERSON_ID" class="events.Person"/> 
</set> 


如 你 所 见 ， 两 个 映射 文件 里 都 有 普通 的 set 了 映射。 注意 在 两 个 映射 文件 中 ， 互 换 
了 key 和 many-to-many 的 字段 名 。 这 里 最 重要 的 是 Event 映射 文件 里 增加 
了 set 元素 的 inverse="true" 属性 。 


这 意味 着 在 需要 的 时 候 ，Hibernate 能 在 关联 的 另 一 端 — Person 类 得 到 两 个 实体 
间 关 联 的 信息 。 这 将 会 极 大 地 帮助 你 理解 双向 关联 是 如 何在 两 个 实体 间 被 创建 的 。 


1.3.6. 使 双向 连 起 来 


首先 请 记 住 ，Hibernate 并 不 影响 通常 的 Java 语 义 。 在 单 向 关联 的 例子 中 ， 我 们 是 
怎样 在 Person 和 Event 之 间 创 建 联系 的 ?我 们 把 Event 实例 添加 

到 Person 实例 内 的 event 引 用 集合 里 。 因 此 很 显然 ， 如 果 我 们 要 让 这 个 关联 可 以 
双向 地 工作 ， 我 们 需要 在 另外 一 端 做 同 祥 的 事情 一 把 Person 实例 加 

A Event 类 内 的 Person 引 用 集合 。 这 “在 关联 的 两 端 设 置 联系 "是 完全 必要 的 而 且 
你 都 得 这 么 做 。 


许多 开发 人 员 防 御 式 地 编程 ， 创 建 管 理 关 联 的 方法 来 保证 正确 的 设置 了 关联 的 两 
端 ， 比 如 在 Person 里 : 


protected Set getEvents() { 
return events; 
} 


protected void setEvents(Set events) { 
this.events = events; 
} 


public void addToEvent(Event event) { 
this.getEvents().add(event); 
event.getParticipants().add(this); 
} 


public void removeFromEvent(Event event) { 
this.getEvents().remove(event); 
event.getParticipants().remove(this); 


注意 现在 对 于 集合 的 get 和 set 方 法 的 访问 级 别 是 protected - 这 人 允许 在 位 于 同一 个 包 

(package) 中 的 类 以 及 继承 自 这 个 类 的 子 类 可 以 访问 这 些 方法 ， 但 禁止 其 他 任何 
人 的 直接 访问 ， 如 免 了 集合 内 容 的 混乱 。 你 应 尽 可 能 地 在 另 一 端 也 把 集合 的 访问 级 
别 设 成 protected。 


inverse 了 映射 属性 究竟 表示 什么 呢 ? 对 于 你 和 Java 来 说 ， 一 个 双向 关联 仅仅 是 在 
两 端 简 单 地 正确 设置 引用 。 然 而 ，Hibernate 并 没有 足够 的 信息 去 正确 地 执 

行 INSERT 和 UPDATE 语句 (以 避免 违反 数据 库 约束 ) ， 所 以 它 需 要 一 些 帮助 来 
正确 的 处 理 双向 关联 。 把 关联 的 一 端 设置 为 inverse 将 告诉 Hibernate 忽 略 关联 的 
这 一 端 ， 把 这 端 看 成 是 另外 一 端的 一 个 镜 象 (miror) 。 这 就 是 所 需 的 全 部 信息 ， 
Hibernate 利 用 这 些 信 息 来 处 理 把 一 个 有 向 导航 模型 转移 到 数据 库 schema 时 的 所 有 
问题 。 你 只 需要 记 住 这 个 直观 的 规则 : 所 有 的 双向 关联 需要 有 一 端 被 设置 

为 inverse 。 在 一 对 多 关联 中 它 必 须 是 代表 多 (many) 的 那 端 。 而 在 多 对 多 
(many-to-many) 关联 中 ， 你 可 以 任意 选取 一 端 ， 因 为 两 端 之 间 并 没有 差别 。 


让 我 们 把 进入 一 个 小 型 的 web 应 用 程序 。 


1.4. 第 三 部 分 - EventManager web ù His 


Hibernate web 应 用 程序 使 用 Session 和 Transaction 的 方式 几乎 和 独立 应 用 
程序 是 一 样 的 。 但 是 ， 有 一 些 常见 的 模式 (pattern) 非常 有 用 。 现 在 我 们 编写 一 
个 EventManagerServlet 。 这 个 servlet 可 以 列 出 数据 库 中 保存 的 所 有 的 events， 
还 提供 一 个 HTML 表 单 来 增加 新 的 events。 


1.4.1. 编写 基本 的 servlet 
在 你 的 源 代码 目录 的 events 包 中 创建 一 个 新 的 类 : 


package events; 
// Imports 
public class EventManagerServlet extends HttpServlet { 


// Servlet code 


我 们 后 面 会 用 到 dateFormatter WWIE, 它 把 Date 对 象 转 换 为 字符 串 。 只 要 
一 个 formatter 作 为 servlet 的 成 员 就 可 以 了 。 


这 个 servlet 只 处 理 HTTP GET 请 求 ， 因 此， 我 们 要 实现 的 是 doGet() 方法 : 


protected void doGet(HttpServletRequest request, 
HttpServletResponse response) 
throws ServletException, IOException { 


SimpleDateFormat dateFormatter = new SimpleDateFormat("dd.MM.y\ 


try { 
// Begin unit of work 


HibernateUtil.getSessionFactory() 
.getCurrentSession().beginTransaction(); 


// Process request and render page... 


// End unit of work 
HibernateUtil.getSessionFactory() 
.getCurrentSession().getTransaction().commit(); 


} catch (Exception ex) { 
HibernateUtil.getSessionFactory() 
.getCurrentSession().getTransaction().rollback(); 
throw new ServletException(ex); 











我 们 称 这 里 应 用 的 模式 为 每 次 请 求 一 个 session(session-per-request)。 当 有 请 求 到 
达 这 个 servlet 的 时 候 ， 通 过 对 SessionFactory 的 第 一 次 调用 ， 打 开 一 个 新 的 
Hibernate Session 。 然 后 启动 一 个 数据 库 事 务 一 所 有 的 数据 访问 都 是 在 事务 中 
进行 ， 不 管 是 读 还 是 写 (我 们 在 应 用 程序 中 不 使 用 auto-commit 模 式 ) 。 


不 要 为 每 次 数据 库 操 作 都 使 用 一 个 新 的 Hibernate Session 。 将 Hibernate 
Session 的 范围 设置 为 整个 请 求 。 要 用 getcurrentSession() ， 这 样 它 自动 会 
绑 定 到 当前 Java 线 程 。 


下 一 步 ， 对 请 求 的 可 能 动作 进行 处 理 ， 泻 染 出 反馈 的 HTML。 我 们 很 快 就 会 涉及 到 
那 部 分 。 


最 后 ， 当 义理 与 泻 染 都 结束 的 时 候 ， 这 个 工作 单元 就 结束 了 。 假 若 在 义理 或 泻 染 的 
时 候 有 任何 错误 发 生 ， 会 抛 出 一 个 异常 ， 回 滚 数据 库 事 务 。 这 

样 ， session-per-request 模式 就 完成 了 。 为 了 避免 在 每 个 servlet 中 都 编写 事务 
边界 界定 的 代码 ， 可 以 考虑 写 一 个 servlet 过 滤器 (filter) 来 更 好 地 解决 。 关 于 这 一 
模式 的 更 多 信息 ， 请 参阅 Hibernate 网 站 和 Wiki， 这 一 模式 叫做 Open Session in 
ee (view) ， 而 不 是 在 servlet 中 ， 你 就 会 很 
快 用 到 它 。 


1.4.2. 义理 与 泻 染 
我 们 来 实现 义理 请 求 以 及 演 染 页 面 的 工作 。 


// Write HTML header 
PrintwWriter out = response.getWriter(); 
out.printin("<html><head><title>Event Manager</title></head><body>' 


// Handle actions 
if ( "store".equals(request.getParameter("action")) ) { 


String eventTitle = request.getParameter("eventTitle"); 
String eventDate = request.getParameter("eventDate"); 


if ( "".equals(eventTitle) || "".equals(eventDate) ) { 
out.printin("<b><i>Please enter event title and date.</i><, 
} else { 
createAndStoreEvent(eventTitle, dateFormatter.parse(eventDé 
out.printiln("<b><i>Added event .</i></b>"); 


} 


// Print page 
printEventForm(out); 
listEvents(out, dateFormatter); 


// Write HTML footer 
out.printiln("</body></html>") ; 
out.flush(); 

out.close(); 


eae 
listEvents() 方法 使 用 绑 定 到 当前 线程 的 Hibernate Session 来 执行 查询 : 





private void listEvents(PrintWriter out, SimpleDateFormat dateFormé 


List result = HibernateUtil.getSessionFactory( ) 


.getCurrentSession().createCriteria(Event.clas: 


if (result.size() > 0) { 


out. 
out. 
out. 
out. 
out. 
out. 


for 


println("<h2>Events in database:</h2>"); 
println("<table border='1'>"); 

printin("<tr>"); 

println("<th>Event title</th>"); 
println("<th>Event date</th>"); 

println("</tr>"); 

(Iterator it = result.iterator(); it.hasNext();) { 
Event event = (Event) it.next(); 
out.println("<tr>"); 

out.println("<td>" + event.getTitle() + "</td>"); 
out.println("<td>" + dateFormatter.format(event.getDate 
out .println("</tr>"); 


.println("</table>"); 





最 后 ， store 动作 会 被 导向 到 createAndStoreEvent() 方法 ， 它 也 使 用 当前 线 
程 的 Session 


protected void createAndStoreEvent(String title, Date theDate) { 
Event theEvent = new Event(); 
theEvent .setTitle(title); 
theEvent.setDate(theDate) ; 


HibernateUtil.getSessionFactory( ) 


.getCurrentSession().save(theEvent); 


大 功 告 成 ， 这 个 servlet 写 完了 。Hibernate 会 在 单一 的 Session 

和 Transaction 中 处理 到 达 的 servlet 请 求 。 如 同 在 前 面 的 独立 应 用 程序 中 那样 ， 
Hibernate 可 以 自动 的 把 这 些 对 象 绑 定 到 当前 运行 的 线程 中 。 这 绘 了 你 用 任何 你 喜欢 
的 方式 来 对 代码 分 层 及 访问 SessionFactory 的 自由 。 通 常 ， 你 会 用 更 加 完 各 的 
设计 ， 把 数据 访问 代码 转移 到 数据 访问 对 象 中 (DAO 模 式 ) 。 请 参见 Hibernate 
Wiki， 那 里 有 更 多 的 例子 。 


1.4.3. BAS mix 


要 发 布 这 个 程序 ， 你 得 把 它 打 成 web 发 布 包 : WAR 文 件 。 把 下 面 的 脚本 加 入 到 你 
的 build.xml 中 : 


<target name="war" depends="compile"> 
<war destfile="hibernate-tutorial.war" webxml="web.xml"> 
<lib dir="${librarydir}"> 
<exclude name="jsdk*.jar"/> 
</lib> 


<classes dir="${targetdir}"/> 
</war> 
</target> 


这 段 代 码 在 你 的 开发 目录 中 创建 一 个 hibernate-tutorial.war 的 文件 。 它 把 所 
有 的 类 库 和 web.xml 描述 文件 都 打包 进去 ，web.xml 文件 应 该 位 于 你 的 开发 根 目 
录 中 : 


<?xml version="1.0" encoding="UTF-8"?> 

<web-app version="2.4" 
xmlns="http://java.sun.com/xml/ns/j2ee" 
xmins:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xSi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://javé 


<servlet> 
<servlet-name>Event Manager</servlet-name> 
<servlet-class>events.EventManagerServlet</servlet-class> 
</servlet> 


<servlet -mapping> 
<servlet-name>Event Manager</servlet-name> 
<url-pattern>/eventmanager</url-pattern> 
</servlet -mapping> 
</web-app> 


eA O - 





请 注意 在 你 编译 和 部 署 web 应 用 程 之 前 ， 需 要 一 个 附加 的 类 库 : jsdk.jar 。 这 是 
Java Servlet 开 发 包 ， 假 若 你 还 没有 ， 可 以 从 Sun 网 站 上 下 载 ， 把 它 copy 到 你 的 lib 目 
录 。 但 是 ， 它 仅仅 是 在 编译 时 需要 ， 不 会 被 打 入 WAR 包 。 


在 你 的 开发 目录 中 ， 调 用 ant war 来 构建 、 打 包 ， 然 后 

把 hibernate-tutorial.war 文件 拷贝 到 你 的 tomcat 的 webapps 目录 下 。 假 若 
你 还 没 安装 Tomcat， 就 去 下 载 一 个 ， 按 照 指 南 来 安装 。 对 此 点 用 的 发 布 ， 你 不 需 
修改 任何 Tomcat 的 配置 。 


RBS, Éz Tomcat A, Ñ 

过 http://localhost :8080/hibernate-tutorial/eventmanager 进行 访问 你 的 
应 用 ， 在 第 一 次 servlet 请 求 发 生 时 ， 请 在 Tomcat log 中 确认 你 看 到 Hibernate 被 初始 
{67 ( HibernateUtil 的 静态 初始 化 器 被 调用 ) ， 假 若 有 任何 异常 抛 出 ， 也 可 以 
看 到 详细 的 输出 。 


1.5. 总 对 


本 章 覆 盖 了 如 何 编写 一 个 简单 独立 的 Hibernate 命 令 行 应 用 程序 及 小 型 的 Hibernate 

web 应 用 程序 的 基本 要 素 。 

如 果 你 已 经 对 Hibernate 感 到 自信 ， 通 过 开发 指南 目录 ， 继 续 浏 览 你 感 兴趣 的 内 容 一 
那些 会 被 问 到 的 问题 大 多 是 事务 处 理 (第 11 章 事务 和 并 发 )， 抓 取 (fetch) 的 效率 
(第 19 章 提升 性 能 )， 或 者 API 的 使 用 (第 10 章 与 对 象 共 事 ) 和 查询 的 特性 (第 10.4 
节 “ 查 询 ”)。 

别 忘 了 去 Hibernate 的 网 站 查看 更 多 (有 针对 性 的 ) 示例 。 


第 2 章 体系 结构 (Architecture) 


m 
su 


2.1. 概况 (Overview) 

2.2. 实例 状态 

2.3. JMX 整 合 

2.4. 对 JCA 的 支持 

2.5. 上 下 文 相关 的 (Contextual) Session 


2.1. 概况 (Overview) 


一 个 非常 简要 的 Hibernate 体 系 结构 的 概要 图 : 
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从 这 个 图 可 以 看 出 ，Hibernate 使 用 数据 库 和 配置 信息 来 为 应 用 程序 提供 持久 化 服务 
(以 及 持久 的 对 象 ) 。 


我 们 来 更 详细 地 看 一 下 Hibernate 运 行 时 体系 结构 。 由 于 Hibernate 非 常 灵 活 ， 且 支 
持 多 种 点 用 方案 ， 所 以 我 们 这 只 描述 一 下 两 种 极端 的 情况 。 “轻型 "的 体系 结构 方 
案 ， 要 求 应 用 程序 提供 自己 的 JDBC 连接 并 管理 自己 的 事务 。 这 种 方案 使 用 了 
Hibernate API 的 最 小 子 集 : 


Persistent 
Objects 


Transient Objects | Application 


SessionFactory Session JDBC | | JNDI | | JTA 


Database 


“全 面 解决 "的 体系 结构 方案 ， 将 应 用 层 从 底层 的 JDBC/JTA API 中 抽象 出 来 ， 而 让 
Hibernate 来 处 理 这 些 细节 。 


Transient Objects | Application 
Persistent 
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Database 


图 中 各 个 对 象 的 定义 如 下 : 
SessionFactory ( org.hibernate.SessionFactory ) 
针对 单个 数据 库 映 射 和 关系 经 过 编译 后 的 内 存 镜像 ， 是 线程 安全 的 (FA). Ce 


生成 Session 的 工厂 ， 本 身 要 用 到 connectionProvider 。 该 对 象 可 以 在 进程 
或 集群 的 级 别 上 ， 为 那些 事务 之 间 可 以 重用 的 数据 提供 可 选 的 二 级 缓存 。 


Session ( org.hibernate.Session ) 


表示 应 用 程序 与 持久 储存 层 之 间 交 互 操 作 的 一 个 单线 程 对 象 ， 此 对 象 生存 期 很 短 。 
其 隐藏 了 JDBC 连 接 ， 也 是 Transaction 的 工厂 。 其 会 持 有 一 个 针对 持久 化 对 象 
的 必 选 (第 一 级 ) 缓存 ， 在 通 历 对 象 图 或 者 根据 持久 化 标识 查找 对 象 时 会 用 到 。 


持久 的 对 象 及 其 集合 


带 有 持久 化 状态 的 、 具 有 业务 功能 的 单线 程 对 象 ， 此 对 象 生 存 期 很 短 。 这 些 对 象 可 
能 是 普通 的 JavaBeans/POJO， 唯 一 特殊 的 是 他 们 正 与 (i—i) Session 相 
关联 。 一 旦 这 个 Session 被 关闭 ， 这 些 对 象 就 会 脱离 持久 化 状态 ， 这 样 就 可 被 应 
用 程序 的 任何 层 自由 使 用 。 (例如 ， 用 作 跟 表示 层 打 交道 的 数据 传输 对 象 。) 


瞬 态 (transient) 和 脱 管 (detached) 的 对 象 及 其 集合 


那些 目前 没有 与 session 关 联 的 持久 化 类 实例 。 他 们 可 能 是 在 被 应 用 程序 实例 化 
后 ， 尚 未 进行 持久 化 的 对 象 。 也 可 能 是 因为 实例 化 他 们 的 Session 已 经 被 关闭 而 
脱离 持久 化 的 对 象 。 


事务 Transaction ( org.hibernate.Transaction ) 


(可 选 的 ) 应 用 程序 用 来 指定 原子 操作 单元 范围 的 对 象 ， 它 是 单线 程 的 ， 生 命 周 期 
Re. 它 通过 抽象 将 应 用 从 底层 具体 的 JDBC、JTA 以 及 CORBA 事 务 隔 离开。 某 
些 情况 下 ， 一 个 Session 之 内 可 能 包含 多 个 Transaction 对 象 。 尽管 是 否 使 用 
该 对 象 是 可 选 的 ， 但 无 论 是 使 用 底层 的 API 还 是 使 用 Transaction tR, BAI 
界 的 开 书 与 关闭 是 必 不 可 少 的 。 


ConnectionProvider ( org.hibernate.connection.ConnectionProvider ) 


(可 选 的 ) 生成 JDBC 连 接 的 工厂 (同时 也 起 到 连接 池 的 作用 ) 。 它 通 过 抽象 将 应 
用 从 底层 的 Datasource 或 DriverManager 隔离 开 。 仅 供 开发 者 扩展 /实现 用 ， 
并 不 暴露 给 应 用 程序 使 用 。 


TransactionFactory ( org.hibernate.TransactionFactory ) 


(可 选 的 ) 生成 Transaction 对 象 实例 的 工厂 。 仅 供 开发 者 扩展 /实现 用 ， 并 不 
暴露 给 应 用 程序 使 用 。 


扩展 接口 


Hibernate 提 供 了 很 多 可 选 的 扩展 接口 ， 你 可 以 通过 实现 它们 来 定制 你 的 持久 层 的 行 
为 。 具体 请 参考 API 文 档 。 


在 特定 “轻型 "的 体系 结构 中 ， 应 用 程序 可 能 绕 过 
Transaction / TransactionFactory 以 及 ConnectionProvider 等 API 直 接 
跟 JTA 或 JDBC 打 交道 。 


2.2. 实例 状态 


一 个 持久 化 类 的 实例 可 能 处 于 三 种 不 同 状态 中 的 某 一 种 。 这 三 种 状态 的 定义 则 与 所 
谓 的 持久 化 上 下 文 (persistence context) 有 关 。 Hibernate 的 Session 对象 就 是 这 
个 所 谓 的 持久 化 上 下 文 : 

BA (transient) 

该 实例 从 未 与 任何 持久 化 上 下 文 关 联 过 。 它 没有 持久 化 标识 (相当 于 主键 值 ) 。 
持久 化 (persistent) 


实例 目前 与 某 个 持久 化 上 下 文 有 关联 。 它 拥有 持久 化 标识 (相当 于 主键 值 ) ， 并 且 
可 能 在 数据 库 中 有 一 个 对 应 的 行 。 对 于 某 一 个 特定 的 持久 化 上 下 文 ，Hibernate 保 
证 持久 化 标识 与 Java 标 识 〈 其 值 代表 对 象 在 内 存 中 的 位 置 ) 等 价 。 


脱 管 (detached) 


实例 佛经 与 某 个 持久 化 上 下 文 发 生 过 关联 ， 不 过 那个 上 下 文 被 关闭 了 ， 或 者 这 个 实 
例 是 被 序列 化 (serialize) 到 另外 的 进程 。 它 拥 有 持久 化 标识 ， 并 且 在 数据 库 中 可 能 
存在 一 个 对 应 的 行 。 对 于 脱 管状 态 的 实例 ，Hibernate 不 保证 任何 持久 化 标识 和 
Java 标 识 的 关系 。 


2.3. JMX 整 合 


JMX 是 管理 Java 组 件 (Java components) 的 J2EE 标 准 。 Hibernate 可 以 通过 一 个 
JMX 标 准 服务 来 管理 。 在 这 个 发 行 版 本 中 ， 我 们 提供 了 一 个 MBean 接 口 的 实现 , 即 


org.hibernate.jmx.HibernateService o 


想 要 看 如 何在 JBoss 应 用 服务 器 上 将 Hibernate 部 署 为 一 个 JMX 服 务 的 例子 ， 您 可 以 
参考 JBoss 用 户 指南 。 我 们 现在 说 一 下 在 Jboss 应 用 服务 器 上 ， 使 用 JMX 来 部 署 
Hibernate 的 好 人 多 : 


e Session 管 理 : Hibernate 的 session 对 象 的 生命 周期 可 以 自动 跟 一 个 JTA 事 
务 边界 绑 定 。 这 意味 着 你 无 需 手工 开关 Session 7, 这 项 工作 会 由 JBoss 
EJB 拦截 器 来 完成 。 你 再 也 不 用 担心 你 的 代码 中 的 事务 边界 了 (除非 你 想 利用 
Hibernate 提 供 可 选 的 Transaction APl 来 自己 写 一 个 便于 移植 的 的 持久 
层 )。 你 通过 调用 HibernateContext 来 访问 Session 。 


e HAR 部 署 : 通常 情况 下 ， 你 会 使 用 JBoss 的 服务 部 署 描述 符 〈 在 EAR 或 /和 SAR 
文件 中 ) 来 部 署 Hibernate JMX 服 务 。 这 种 部 署 方式 支持 所 有 常见 的 Hibernate 
SessionFactory 的 配置 选项 。 不 过 ， 你 仍 需 在 部 署 描述 符 中 ， 列 出 你 所 有 
的 映射 文件 的 名 字 。 如 果 你 使 用 HAR 部 署 方式 , JBoss 会 自动 探测 出 你 的 HAR 
文件 中 所 有 的 映射 文件 。 


这 些 选项 更 多 的 描述 ， 请 参考 JBoss 应 用 程序 用 户 指南 。 


将 Hibernate 以 部 署 为 JMX 服 务 的 另 一 个 好 处 ， 是 可 以 查看 Hibernate 的 运行 时 统计 
Z8. BS 第 3.4.6 节 “ Hibernate 的 统计 (statistics) 机 制 ” 


2.4. 对 JCA 的 支持 


Hibernate 也 可 以 被 配置 为 一 个 JCA 连 接 器 (JCAconnector) 。 更 多 信息 请 参看 网 
站 。 请 注意 ，Hibernate 对 JCA 的 支持 ， 仍 处 于 实验 性 阶段 。 


2.5. 上 下 文 相 关 的 (Contextual) Session 


使 用 Hibernate 的 大 多 数 应 用 程序 需要 某 种 形式 的 * 上 下 文 相关 的 ” session， 特 定 的 
session 在 整个 特定 的 上 下 文 范 围 内 始终 有 效 。 然 而 ， 对 不 同类 型 的 应用 程序 而 言 ， 
要 为 什么 是 组 成 这 种 “上 下 文 " 下 一 个 定义 通常 是 困难 的 ; 不 同 的 上 下 文 对 “当前 ”这 个 

念 定 义 了 不 同 的 范围 。 在 3.0 版 本 之 前 ， 使 用 Hibernate 的 程序 要 么 采用 自行 编写 
的 基于 ThreadLocal 的 上 下 文 Session， 要 么 采用 HibernateUtil 这 样 的 辅助 
类 ， 要 么 采用 第 三 方 框架 (比如 Spring 或 Pico)， 它 们 提供 了 基于 代理 (proxy) 或 者 基 
于 拦截 器 (interception) 的 上 下 文 相关 session。 


从 3.0.1 版 本 开始 ，Hibernate 增 加 了 SessionFactory.getCurrentSession() A 
法 。 一 开始 ， 它 假定 了 采用 JTA 事务 ， JTA 事务 定义 了 当前 session 的 范围 和 上 
下 文 (scope and context)。Hibernate 开 发 团队 坚信 ， 因 为 有 好 几 个 独立 

的 JTA TransactionManager 实现 稳定 可 用 ， 不 论 是 否 被 部 署 到 一 个 J2EE 容器 
中 ， 大 多 数 (假若 不 是 所 有 的 ) 应 用 程序 都 应 该 采用 JTA 事务 管理 。 基 于 这 一 点 ， 

采用 ITA 的 上 下 文 相 关 session 可 以 满足 你 一 切 需要 。 


更 好 的 是 ， 从 3.1 开 始 ， SessionFactory.getCurrentSession() 的 后 台 实 现 是 
可 拔 插 的 。 因 此 ， 我 们 引入 了 新 的 扩展 接口 

( org.hibernate.context.CurrentSessioncontext ) 和 新 的 配置 参数 

( hibernate.current_session_context_class )， 以 便 对 什么 是 “当前 
session" 的 范围 和 上 下 文 (scope and context) 的 定义 进行 拔 插 。 


请 参阅 org. hibernate.context.CurrentSessionContext 接口 的 Javadoc, 那 里 
有 关于 它 的 契约 的 详细 讨论 。 它 定义 了 单一 的 方法 ， currentSession() ， 特 定 
的 实现 用 它 来 负责 跟踪 当前 的 上 下 文 Session。Hibernate 内 置 了 此 接口 的 三 种 实 
现 。 


e org.hibernate.context.JTASessionContext - 当前 session 根 据 JTA 来 
跟踪 和 界定 。 这 和 以 前 的 仅 支 持 JTA 的 方法 是 完全 一 样 的 。 详 情 请 参阅 
Javadoc。 


e org.hibernate.context.ThreadLocalSessionContext - 当前 session 通 
过 当前 执行 的 线程 来 跟踪 和 界定 。 详 情 也 请 参阅 Javadoc。 


e org.hibernate.context.ManagedSessionContext - 当前 session 通 过 当前 
执行 的 线程 来 跟踪 和 界定 。 但 是 ， 你 需要 负责 使 用 这 个 类 的 静态 方法 
将 Session 实例 绑 定 、 或 者 取消 绑 定 ， 它 并 不 会 打开 (open)、flush 或 者 关闭 
(close) 任 何 Session 。 


前 两 种 实现 都 提供 了 “每 数据 库 事务 对 应 一 个 session" 的 编程 模型 ， 也 称 作 每 次 请 求 
一 个 session。 Hibernate session 的 起 始 和 终结 由 数据 库 事务 的 生存 来 控制 。 假 若 你 
在 纯粹 的 Java SE 之 上 采用 自行 编写 代码 来 管理 事务 ,而 不 使 用 JTA， 建 议 你 使 用 
Hibernate Transaction APl 来 把 底层 事务 实现 从 你 的 代码 中 隐藏 掉 。 如 果 你 使 
用 JTA， 请 使 用 JTA 借 口 来 管理 Transaction。 如 果 你 在 支持 CMT 的 EJB 容 器 中 执行 
代码 ， 事 务 边 界 是 声明 式 定义 的 ， 你 不 需要 在 代码 中 进行 任何 事务 或 session 管 理 操 
作 。 请 参阅 第 11 章 事务 和 并 发 一 节 来 阅读 更 多 的 内 容 和 示例 代码 。 


hibernate.current_session_context_class 配置 参数 定义 了 应 该 采用 哪 

个 org.hibernate.context.CurrentSessionContext ¥ M. SEM, ASTM RH 
容 ， 如 果 未 配置 此 参数 ， 但 是 存 

在 org.hibernate.transaction.TransactionManagerLookup 的 配置 ， 
Hibernate 会 采用 org.hibernate.context.JTASessionContext 。 一 般 而 言 ， 此 
参数 的 值 指明 了 要 使 用 的 实现 类 的 全 名 ， 但 那 三 种 内 置 的 实现 可 以 使 用 简写 ， 

即 "jta"、"thread" 和 "managed"。 
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由 于 Hibernate 是 为 了 能 在 各 种 不 同 环境 下 工作 而 设计 的 , 因此 存在 着 大 量 的 配置 参 
数 . 幸运 的 是 多 数 配置 参数 都 有 比较 直观 的 默认 值 , 并 有 随 Hibernate 一 同 分 发 的 配 
置 样 例 hibernate.properties (位 于 etc/ ) 来 展示 各 种 配置 选项 . 所 需 做 的 仅 
仅 是 将 这 个 样 例文 件 复制 到 类 路 径 (classpath) 下 并 做 一 些 自 定义 的 修改 . 


3.1. 可 编程 的 配置 方式 


一 个 org.hibernate.cfg.Configuration 实例 代表 了 一 个 应 用 程序 中 Java 类 型 
到 SQL 数据 库 映 射 的 完整 集合 .configuration 被 用 来 构建 一 个 (不 可 变 的 
(immutable)) SessionFactory . 映射 定义 则 由 不 同 的 XML 映射 定义 文件 编译 而 来 . 


你 可 以 直接 实例 化 configuration 来 获取 一 个 实例 ， 并 为 它 指定 XML 映射 定义 文 
件 . 如 果 映 射 定 义 文 件 在 类 路 径 (classpath) 中 , 请 使 用 addResource() : 


Configuration cfg = new Configuration() 
.addResource("Item.hbm.xm1") 
.addResource("Bid.hbm. xml"); 


一 个 替代 方法 (有 时 是 更 好 的 选择 ) 是 ， 指 定 被 映射 的 类 ， 让 Hibernate 帮 你 寻找 映 
射 定义 文件 : 


Configuration cfg = new Configuration() 
.addClass(org.hibernate.auction.Item.class) 
.addClass(org.hibernate.auction.Bid.class); 


Hibernate 将 会 在 类 路 径 (classpath) 中 寻找 名 字 为 
/org/hibernate/auction/Item.hbm.xml 和 
/org/hibernate/auction/Bid.hbm.xml 映射 定义 文件 . 这 种 方式 消除 了 任何 对 

文件 名 的 硬 编码 (hardcoded). 


Configuration 也 人 允许 你 指定 配置 属性 : 


Configuration cfg = new Configuration() 
.addClass(org.hibernate.auction.Item.class) 
.addClass(org.hibernate.auction.Bid.class) 
.setProperty("hibernate.dialect", "org.hibernate.dialect.MySQL: 
.setProperty("hibernate.connection.datasource", "java:comp/env, 
.setProperty("hibernate.order_updates", "true"); 


<] = ;; 
当然 这 不 是 唯一 的 传递 Hibernate 配 置 属性 的 方式 , 其 他 可 选 方式 还 包括 : 


1. 传 一 个 java.util.Properties 实例 给 
Configuration.setProperties() . 





2. 将 hibernate.properties 放置 在 类 路 径 (classpath) 的 根 目 录 下 (root 
directory). 


3. 通过 java -Dproperty=value 来 设置 系统 ( System ) 属 性 . 


4. 在 hibernate.cfg.xml 中 加 入 元 素 &lt;property&gt; ( 稍 后 讨论 )， 
如 果 想 尽快 体验 Hibernate，hibernate.properties 是 最 简单 的 方式 . 


Configuration 实例 被 设计 成 启动 期 间 (startup-time) 对 象 , 一 
H sessionFactory 创建 完成 它 就 被 丢弃 了 . 


3.2. 获得 SessionFactory 


当 所 有 了 映射 定义 被 Configuration 解析 后 , 应 用 程序 必须 获得 一 个 用 于 构 


造 Session 实例 的 工厂 . 这 个 工厂 将 被 应 用 程序 的 所 有 线程 共享 : 


SessionFactory sessions = cfg.buildSessionFactory(); 


Hibernate 人 允许 你 的 应 用 程序 创建 多 个 SessionFactory 实例 . 这 对 使 用 多 个 数据 
库 的 应 用 来 说 很 有 用 . 


3.3. JDBC 连 接 


通常 你 希望 SessionFactory 来 为 你 创建 和 缓存 (pool)JDBC 连 接 . 如 果 你 采用 这 种 
方式 , 只 需要 如 下 例 所 示 那 样 ， 打 开 一 个 Session : 


Session session = sessions.openSession(); // open a new Session 


一 旦 你 需要 进行 数据 访问 时 , 就 会 从 连接 池 (connection pool) 获 得 一 个 JDBC 连 接 . 


为 了 使 这 种 方式 工作 起 来 , 我 们 需要 向 Hibernate 传 递 一 些 JDBC 连 接 的 属性 . 所 有 
Hibernate 属 性 的 名 字 和 语义 都 在 org.hibernate.cfg.Environment 中 定义 .我 
们 现在 将 描述 JDBC 连 接 配置 中 最 重要 的 设置 . 


如 果 你 设置 如 下 属性 ，Hibernate 将 使 用 java.sql.DriverManager 来 获得 (和 缓 
存 )JDBC 连 接 : 


表 3.1. Hibernate JDBC 属 性 


属性 名 用 途 
hibernate.connection.driver_class jdbc 驱动 类 
hibernate.connection.url jdbc URL 
hibernate.connection. username 数据 库 用 户 
hibernate.connection. password 数据 库 用 户 密码 
hibernate.connection.pool_size 连接 池 容 量 上 限 数目 


但 Hibernate 自 带 的 连接 池 算 法 相当 不 成 熟 . 它 只 是 为 了 让 你 快 些 上 手 ， 并 不 适合 用 
于 产品 系统 或 性 能 测试 中 。 出 于 最 佳 性 能 和 稳定 性 考虑 你 应 该 使 用 第 三 方 的 连接 
池 。 只 需要 用 特定 连接 池 的 设置 替换 hibernate.connection.pool_size 即 可 。 
这 将 关闭 Hibernate 自 带 的 连接 池 . 例如 , 你 可 能 会 想 用 C3P0. 


C3P0 是 一 个 随 Hibernate 一 同 分 发 的 开源 的 JDBC 连 接 池 , 它 位 于 lib 目录 下 。 如 
果 你 设置 了 hibernate.c3po.* 相关 的 属性 , Hibernate 将 使 用 
C3POConnectionProvider 来 缓存 JDBC 连 接 . 如 果 你 更 原意 使 用 Proxool, 请 参考 
发 行 包 中 的 hibernate.properties 并 到 Hibernate 网 站 获取 更 多 的 信息 . 


这 是 一 个 使 用 C3P0 的 hibernate.properties 样 例文 件 : 


hibernate.connection.driver_class = org.postgresql.Driver 
hibernate.connection.url = jdbc:postgresql://localhost/mydatabase 
hibernate.connection.username myuser 
hibernate.connection.password secret 

hibernate.c3p0.min_size=5 

hibernate.c3p0.max_size=20 

hibernate.c3p0. timeout=1800 

hibernate.c3p0.max_statements=50 

hibernate.dialect = org.hibernate.dialect .PostgreSQLDialect 


‘| = as) 





为 了 能 在 应 用 程序 服务 器 (application server) 中 使 用 Hibernate, 应 当 总 是 将 
Hibernate 配置 成 从 注册 在 JNDI 中 的 Datasource 义 获得 连接 ， 你 至 少 需要 设置 下 
列 属 性 中 的 一 个 : 


表 3.2. Hibernate 数 据 源 属性 


属性 名 用 途 
hibernate.connection.datasource 数据 源 JND/ 名 字 
hibernate. jndi.url JND/ 提 供 者 的 UVRL (可 选 ) 
JNDI 
hibernate. jndi.class InitialContextFactory 类 (可 
选 ) 
hibernate.connection.username 数据 库 用 户 (可 选 ) 
hibernate.connection.password 数据 库 用 户 密码 (可 选 ) 


这 是 一 个 使 用 应 用 程序 服务 器 提供 的 JNDI 数 据 源 的 hibernate.properties 样 例 
文件 : 


hibernate.connection.datasource = java:/comp/env/jdbc/test 
hibernate.transaction.factory_class = \ 
org.hibernate. transaction. JTATransactionFactory 
hibernate.transaction.manager_lookup_class = \ 
org. hibernate. transaction. JBossTransactionManagerLookup 
hibernate.dialect = org.hibernate.dialect .PostgreSQLDialect 


从 JNDI 数 据 源 获得 的 JDBC 连 接 将 自动 参与 到 应 用 程序 服务 器 中 容器 管理 的 事务 
(container-managed transactions) 中 去 . 


任何 连接 (connection) 属 性 的 属性 名 都 要 以 " hibernate.connnection "开头 . 例如 ， 
你 可 能 会 使 用 hibernate.connection.charSet 来 指定 字符 集 charset . 


通过 实现 org.hibernate.connection.ConnectionProvider 接口 ， 你 可 以 定义 
属于 你 自己 的 获得 JDBC 连 接 的 插件 策略 。 通 过 设 
置 hibernate.connection.provider_class ， 你 可 以 选择 一 个 自 定义 的 实现 . 


3.4. 可 选 的 配置 属性 


有 大 量 属性 能 用 来 控制 Hibernate 在 运行 期 的 行为 . 它们 都 是 可 选 的 , 并 拥有 适当 的 
默认 值 . 


警告 : 其 中 一 些 属性 是 "系统 级 (system-levej) 的 " 系统 级 属性 只 能 通 
过 java -Dproperty=value 或 hibernate.properties 来 设置 , 而 不 能 用 上 面 
描述 的 其 他 方法 来 设置 . 


KR 3.3. Hibernate 配 置 属性 


属性 名 用 途 


一 个 Hibernate Dialect 类 名 人 多 
许 Hibernate 针 对 特定 的 关系 数据 
库 生 成 优化 的 SQL. 取 值 


full.classname.of.Dialect 


输出 所 有 SQL 语句 到 控制 台 . 有 
一 个 另外 的 选择 是 
hibernate. show_ sql 把 org.hibernate.SQL 这 个 
log category 设 为 debug 。 eg. 
true | false 


在 log 和 console 中 打印 出 更 漂亮 
的 SQL。 取 值 true | false 


在 生成 的 SQL 中 , 将 给 定 的 
schema/tablespace 附 加 于 非 全 


限定 名 的 表 名 上 . 取 值 
SCHEMA_NAME 


在 生成 的 SQL 中 , 将 给 定 的 


hibernate.default_catalog catalog 附 加 于 非 全 限定 名 的 表 名 
+. 取 值 CATALOG_NAME 


hibernate.dialect 


hibernate. format_sql 


hibernate.default_schema 


SessionFactory 创建 后 ， 将 
自动 使 用 这 个 名 字 绑 定 到 JNDI 
中 . 取 值 


jndi/composite/name 


为 单 向 关联 (一 对 一 , 多 对 一 ) 的 外 
连接 抓 取 (outer join fetch) 树 

hibernate.max_fetch_depth 设置 最 大 深度 . 值 为 0 意味 着 将 
关闭 默认 的 外 连接 抓 取 . 取 值 建 
RE o 到 3 之 间 取 值 


为 Hibernate 关 联 的 批量 抓 取 设置 
hibernate.default_batch_fetch_size 默认 数量 . 取 值 建议 的 取 值 


hibernate.session_factory_name 


hibernate. 


hibernate. 


hibernate. 


hibernate. 


hibernate. 


default_entity_mode 


order_updates 


generate_statistics 


use_identifer_rollback 


use_sql_comments 


> Ae le 


为 由 这 个 SessionFactory 打 
开 的 所 有 Session 指 定 默认 的 实 
体 表 现 模 式 . 取 值 
dynamic-map , 
pojo 

强制 Hibernate 按 照 被 更 新 数据 的 
主键 ， 为 SQL 更 新 排序 。 这 人 么 做 
将 减少 在 高 并 发 系统 中 事务 的 死 
锁 。 取 值 true | false 


MRF £, Hibernate 将 收集 有 助 
于 性 能 调节 的 统计 数据 . 取 值 


true | false 


URF E, 在 对 象 被 删除 时 生成 
的 标识 属性 将 被 重 设 为 默认 值 . 
取 值 true | false 


MRF E, Hibernate 将 在 SQL 中 

生成 有 助 于 调试 的 注释 信息 , 默 

认 值 为 false . 取 值 true | 
false 


dom4j ， 


K 3.4. Hibernate JDBC 和 连接 (connection) 属 性 


hibernate 


hibernate 


hibernate 


hibernate 


hibernate 


属性 名 


“Jdbce.fetch size 


. jdbc .batch_size 


. }dbc .batch_versioned_data 


“jdbc. factory vclass 


. jdbc .use_scrollable_resultset 


Hï 


非 雳 值 ， 指 定 JDBC 抓 取 数 量 
用 Statement .setFetchSi 


非 需 值 ， 人 允许 Hibernate 使 用 
建议 取 5 到 30 之 间 的 值 


如 果 你 想 让 你 的 JDBC 了 驱动 及 
正确 的 行 计数 , AAI 
选项 通常 是 安全 的 ). AA, F 
化 的 数据 使 用 批量 DML. Ski) 


true | false 


选择 一 个 自 定义 的 Batcher 
这 个 配置 属性 . eg. classne 


It i4-Hibernate/# AJDBC2K 
用 用 户 提供 的 JDBC 连 接 时 ， 
则 Hibernate 会 使 用 连接 的 元 


false 


在 JDBC 读 


hibernate.jdbc.use_streams_for_binary 


hibernate. jdbc.use_get_generated_keys 


hibernate.connection. 


hibernate.connection 


hibernate.connection. 


hibernate.connection. 


provider_class 


.isolation 


autocommit 


release mode 


& binary (二 进 制 ) 或 se 
的 类 型 时 使 用 流 (stream)( 系 : 


false 


在 数据 插入 数据 库 之 后 ， 允 i 
PreparedStatement ,getG 
取 数 据 库 生成 的 key( 键 )。 需 
JRE1.4+, 如 果 你 的 数据 库 驱 
识 生 成 器 时 遇 到 问题 ， 请 将 ! 
下 将 使 用 连接 的 元 数据 来 判 ; 
true&#124; false 


HEL ConnectionProvide 


Hibernate 提 供 JDBC 连 接 . H 
classname.of.Connectio 


设置 JDBC 事 务 隔离 级 别 . & 
看 java.sql.Connection 
L, 但 请 注意 多 数 数据 库 都 丰 
fa. l 2 ae 


允许 被 缓存 的 JDBC 连 接 开 具 
(不 建议 ). 取 值 true | fa 


指定 Hibernate 在 何 时 释放 J[ 
到 Session 被 显 式 关 闭 或 被 疼 
JDBC 连 接 . 对 于 应 用 程序 服 
当 使 用 after_statement , 
后 ， 都 会 主动 的 释放 连接 . t 
用 after_transaction 在 : 
是 合理 的 . auto 将 为 JTA 秋 
择 after_statement , 为 J 
择 after_transaction 


取 值 auto (默认 )| on_close | after_transaction | after_statement 


注意 ,这 些 设置 仅 对 通过 SessionFactory.openSession 得 到 的 Session 起 作 

用 。 对 于 通过 SessionFactory.getCurrentSession 得 到 的 Session ， 所 配置 
的 CurrentSessionContext 实现 控制 这 些 Session 的 连接 释放 模式 。 请 参阅 第 
2.5 节 “ 上 下 文 相关 的 (Contextual) Session”. 


|| hibernate.connection._&lt;propertyName&gt;_ | JDBC 
性 propertyName 传递 到 DriverManager.getConnection() FH. | 
hibernate. jndi._&lt;propertyName&gt;_ | 将 属性 propertyName 传递 到 
JNDI InitialcontextFactory 中 去 .| 


表 3.5. Hibernate: TEIE 


hibernate. 


hibernate. 


hibernate. 


hibernate. 


hibernate. 


hibernate. 


hibernate. 


cache. 


cache. 


cache. 


cache. 


cache. 


cache. 


cache. 


属性 名 


provider_class 


use_minimal_puts 


use_query_cache 


use_second level cache 


query_cache_factory 


region_prefix 


use_structured_entries 


K 3.6. HibernateS 4 Bt 


用 途 


自 定义 的 CacheProvider 的 
名 . 取 值 


classname.of.CacheProvi 


以 频繁 的 读 操 作为 代价 , 优化 : 
缓存 来 最 小 化 写 操 作 . 在 
Hibernate3 中 ， 这 个 设置 对 的 
缓存 非常 有 用 , 对 集群 缓存 的 : 
Ms, Piz BA. 取 值 
true&#124; false 


允许 查询 缓存 , 个 别 查询 仍然 ; 
被 设置 为 可 缓存 的 . 取 值 
true&#124; false 


能 用 来 完全 禁止 使 用 二 级 缓存 
那些 在 类 的 映射 定义 中 指 

EŒ &lt;cacheagt; 的 类 ， 会 
AF EZRA. Dia 
true&#124;false 


自 定义 实现 QueryCache 接 [ 
类 名 , 默认 为 内 建 

的 StandardQueryCache . # 
classname.of.QueryCache 


二 级 缓存 区 域名 的 前 级 . 取 值 


prefix 


强制 Hibernate 以 更 人 性 化 的 可 
将 数据 存 人 二 级 缓存 . 取 值 
true&#124; false 


属性 名 


hibernate.transaction.factory_class 


jta.UserTransaction 


hibernate. transaction.manager_lookup_class 


hibernate. transaction. flush_before_completion 


hibernate.transaction.auto_ close session 


表 3.7. 其 他 属性 


一 个 TransactionF 


Hibernate Transact 


为 IDBCTransactio 
classname.of.Tra 


一 个 JNDI 名 字 ， 

被 JTATransaction 
器 获取 JTA Usertra 
jndi/composite/n 


一 个 TransactionM 


使 用 JVM 级 缓存 ， 或 
器 的 时 候 需 要 该 类 . 目 


classname.of.Tra 


如 果 开 启 , session 在 : 
(flush)。 现在 更 好 的 
下 文 管理 。 请 参见 第 
(Contextual) Sess 
false 


如 果 开 启 , session 在 : 
闭 。 现在 更 好 的 方法 
管理 。 请 参见 第 2.5 
(Contextual) Sess 
false 


属性 名 


hibernate.current_session_context_class 


hibernate.query.factory_class 


hibernate. query.substitutions 


hibernate.hbm2dd1.auto 


hibernate.cglib.use_reflection_optimizer 


为 "当前 " Session 指定 一 
情 ， 请 参见 第 2.5 节 “ 上 下 : 
jta | thread | manag 


选择 HQL 解 析 器 的 实现 . 取 . 
org.hibernate.hql.ast 
org.hibernate.hql.cla 


将 Hibernate 查 询 中 的 符号 
名 或 常量 名 字 ). 取 值 
hqlLiteral=SQL_LITERA 


在 SessionFactory 创建 ! 
schema 的 DDL 导 出 到 数据 ， 
闭 SessionFactory 时 ，， 
| update | create | c 


开启 CGLIB 来 替代 运行 时 反 


时 比较 有 用 . 注意 即使 关闭 : 
能 在 hibernate.cfg.xml 


3.4.1. SQL 方言 


你 应 当 总 是 为 你 的 数据 库 将 hibernate.dialect 属性 设置 成 正确 的 
org.hibernate.dialect.Dialect 子 类 . 如 果 你 指定 一 种 方言 , Hibernate 将 为 上 
面 列 出 的 一 些 属性 使 用 合理 的 默认 值 , 为 你 省 去 了 手工 指定 它们 的 功夫 . 


K 3.8. Hibernate SQL 方言 ( hibernate.dialect ) 


RDBMS 
DB2 
DB2 AS/400 
DB2 OS390 
PostgreSQL 
MySQL 
MySQL with InnoDB 


MySQL with 
MyISAM 


Oracle (any version) 
Oracle 9i/10g 
Sybase 

Sybase Anywhere 


Microsoft SQL 
Server 


SAP DB 
Informix 
HypersonicSQL 
Ingres 

Progress 

Mckoi SQL 
Interbase 
Pointbase 
FrontBase 


Firebird 


org. 


org 


org. 


org. 


org 


org. 


org. 


org. 


org. 


org 


org. 


org. 


org. 


org. 


org 


org. 


org. 


org 


org. 
org. 
org. 


org. 


hibernate. 
‘hibernate. 
hibernate. 
hibernate. 
‘hibernate. 


hibernate. 


hibernate. 


hibernate. 
hibernate. 
.hibernate. 


hibernate. 


hibernate. 


hibernate. 
hibernate. 
‘hibernate. 
hibernate. 
hibernate. 
‘hibernate. 
hibernate. 
hibernate. 
hibernate. 


hibernate. 


方言 


dialect. 
dialect. 
dialect. 
dialect. 
dialect. 


dialect. 


dialect. 


dialect. 
dialect. 
dialect. 


dialect. 


dialect. 


dialect. 
dialect. 
dialect. 
dialect. 
dialect. 
dialect: 
dialect. 
dialect. 
dialect. 


dialect. 


DB2Dialect 
DB2400Dialect 
DB2390Dialect 
PostgreSQLDialect 
MySQLDialect 


MySQLInnoDBDialect 
MySQLMyISAMDialect 


OracleDialect 
Oracle9Dialect 
SybaseDialect 


SybaseAnywhereDialect 
SQLServerDialect 


SAPDBDialect 
InformixDialect 
HSQLDialect 
IngresDialect 
ProgressDialect 
MckoiDialect 
InterbaseDialect 
PointbaseDialect 
FrontbaseDialect 


FirebirdDialect 


3.4.2. 外 连接 抓 取 (Outer Join Fetching) 


如 果 你 的 数据 库 支持 ANSI, Oracle 或 Sybase 风格 的 外 连接 , 外 连接 抓 取 通常 能 通过 
限制 往返 数据 库 次 数 (更 多 的 工作 交 由 数据 库 自 己 来 完成 ) 来 提高 效率 . 外 连接 抓 取 
允许 在 单个 SELECT SQL 话 句 中 ， 通过 many-to-one, one-to-many, many-to-many 
和 one-to-one 关 联 获取 连接 对 象 的 整个 对 象 图 . 


将 hibernate.max_fetch_depth 设 为 0 能 在 全 局 范围 内 禁止 外 连接 抓 取 . 设 
为 1 或 更 高 值 能 启用 one-to-one 和 many-to-oneouter 关 联 的 外 连接 抓 取 , 它们 通过 
fetch="join" 来 映射 . 


参见 第 19.1 节 “ 抓 取 策 略 (Fetching strategies) "获得 更 多 信息 . 


3.4.3. 二 进 制 流 (Binary Streams) 


Oracle 限 制 那 些 通过 JDBC 了 驱动 传输 的 字 节 数组 的 数目 . 如 果 你 希望 使 
用 二 进 值 (binary) 或 可 序列 化 的 (serializable) 类 型 的 大 对 象 , 你 应 该 开局 
hibernate.jdbc.use_streams_for_binary 属性 . 这 是 系统 级 属性 . 


3.4.4. 二 级 缓存 与 查询 缓存 


以 hibernate.cache 为 前 级 的 属性 允许 你 在 Hibernate 中 ， 使 用 进程 或 群集 范围 
内 的 二 级 缓存 系统 . 参见 第 19.2 节 “ 二 级 缓存 (The Second Level Cache) “获取 
更 多 的 详情 . 


3.4.5. 查询 语言 中 的 鞋 换 


你 可 以 使 用 hibernate.query.substitutions 在 Hibernate 中 定义 新 的 查询 符号 . 
例如 : 


hibernate.query.substitutions true=1, false=0 


将 导致 符号 true 和 false 在 生成 的 SQL 中 被 翻译 成 整数 常量 . 


hibernate.query.substitutions toLowercase=LOWER 


将 允许 你 重 命名 SQL 中 的 LOWER HŽ. 


3.4.6. Hibernate 的 统计 (statistics) 机 制 


如 果 你 开启 hibernate.generate_statistics ,那么 当 你 通过 
SessionFactory.getStatistics() 调整 正在 运行 的 系统 时 ，Hibernate 将 导出 大 
量 有 用 的 数据 . Hibernate 甚 至 能 被 配置 成 通过 JMX 导 出 这 些 统计 信息 . 参 

考 org.hibernate.stats 中 接口 的 Javadoc， 以 获得 更 多 信息 . 


3.5. 日 志 


Hibernate 使 用 Apache commons-logging 来 为 各 种 事件 记录 日 志 . 


commons-logging 将 直接 输出 到 Apache Log4j( 如 果 在 类 路 径 中 包括 10g4j.jar ) 
或 JDK1.4 logging (如 果 运 行 在 JDK1.4 或 以 上 的 环境 下 ). 你 可 以 

从 http://jakarta.apache.org 下 载 Log4j. 要 使 用 Log4j， 你 需要 

将 log4j.properties 文件 放置 在 类 路 径 下 , 随 Hibernate 一 同 分 发 的 桩 例 属性 文 
件 在 src/ 目录 下 . 


我 们 强烈 建议 你 熟悉 一 lene ees 在 不 失 可 读 Egret 我 们 做 了 
很 多 工作 ， 使 Hibernate 的 日 志 可 能 地 详细 . 这 是 必要 的 查 错 利器 . 最 信人 感 兴趣 的 
日 志 分 类 有 如 下 这 些 : 


表 3.9. Hibernate 日 志 类 别 


类 别 功能 
org.hibernate.SQL a DML 语 句 被 执行 时 为 它们 记录 
/PN 
org.hibernate.type 为 所 有 JDBC 参 数 记 录 日 志 


在 所 有 SQL DDL 语 句 执行 时 为 它们 记录 日 
= = 


/CN 


人 Os LRA 


org.hibernate.tool.hbm2dd1 


org. hibernate.pretty 


org.hibernate.cache ee 
org.hibernate. transaction 为 事务 相关 的 活动 记录 日 志 
org.hibernate. jdbc 为 所 有 JDBC 资 源 的 获取 记录 日 志 
ee ee 
org.hibernate. secure 为 JAAS 认 证 请 求 做 日 志 


. 为 任何 Hibernate 相 关 信 息 做 日 志 (信息 量 
SS BA, 但 对 查 错 非 常 有 帮助 ) 

在 使 用 Hibernate 开 发 应 用 程序 时 , 你 应 当 总 是 为 org.hibernate.SQL F 
É debug 级 别 的 日 志 记 录 , 或 者 开启 hibernate.show_sql 属性 。 


3.6. 实现 NamingStrategy 


org.hibernate.cfg.NamingStrategy 接口 允许 你 为 数据 库 中 的 对 象 和 schema 
元 素 指定 一 个 “命名 标准 ” 


你 可 能 会 提供 一 些 通过 Java 标 识 生 成 数据 库 标识 或 料 映射 定义 文件 中 "逻辑 " 表 / 列 名 
处 理 成 "物理 " 表 / 列 名 的 规则 . 这 个 特性 有 助 于 减少 元 长 的 映射 定义 文件 . 


在 加 入 映射 定义 前 ， 你 可 以 调用 Configuration.setNamingStrategy() 指定 一 
个 不 同 的 命名 策略 : 


SessionFactory sf = new Configuration() 
.setNamingStrategy(ImprovedNamingStrategy. INSTANCE ) 
.addFile("Item.hbm.xm1") 

.addFile("Bid.hbm. xml") 
.buildSessionFactory(); 


org.hibernate.cfg.ImprovedNamingStrategy 是 一 个 内 建 的 命名 策略 , 对 一 些 
应 用 程序 而 言 ， 可 能 是 非常 有 用 的 起 点 . 


3.7. XML 配置 文件 


另 一 个 配置 方法 是 在 hibernate.cfg.xml 文件 中 指定 一 套 完 整 的 配置 . 这 个 文件 
可 以 当成 hibernate.properties 的 替代 。 若 两 个 文件 同时 存在 ， 它 将 覆盖 前 者 
的 属性 . 


XML 配置 文件 被 默认 是 放 在 CLASSPATH 的 根 目 录 下 . 这 是 一 个 例子 


<?xml version='1.0' encoding='utf-8'?> 

<!DOCTYPE hibernate-configuration PUBLIC 
"-//Hibernate/Hibernate Configuration DTD//EN" 
"http://hibernate.sourceforge.net/hibernate-configuration-3.0.¢ 


<hibernate-configuration> 


<!-- 以 /jndi/name 绑 定 到 JNDI 的 SessionFactory 实 例 --> 
<session-factory 
name="java:hibernate/SessionFactory"> 


<!-- 属性 --> 
<property name="connection.datasource">java:/comp/env/jdbc, 
<property name="dialect">org.hibernate.dialect .MySQLDialect 
<property name="Show_sql">false</property> 
<property name="transaction. factory _class"> 

org.hibernate. transaction. JTATransactionFactory 
</property> 
<property name="jta.UserTransaction">java:comp/UserTransact 


<1-- 映射 定义 文件 - -> 
<mapping resource="org/hibernate/auction/Item.hbm.xml"/> 
<mapping resource="org/hibernate/auction/Bid.hbm. xm1"/> 


<!-- 缓存 设置 --> 

<class-cache class="org.hibernate.auction.Item" usage="reac 
<class-cache class="org.hibernate.auction.Bid" usage="read- 
<collection-cache collection="org.hibernate.auction.Item.b: 


</session-factory> 
</hibernate-configuration> 
El ES = 


如 你 所 见 , 这 个 方法 优势 在 于 ， 在 配置 文件 中 指出 了 映射 定义 文件 的 名 字 . 一 旦 你 需 
要 调整 Hibernate 的 缓存 ， hibernate.cfg.xml 也 是 更 方便 . 注意 ， 使 

用 hibernate.properties 还 是 hibernate.cfg.xml 完全 是 由 你 来 决定 , 除了 
上 面 提 到 的 XML 语法 的 优势 之 外 , 两 者 是 等 价 的 . 





使 用 XML 配置 ， 使 得 启动 Hibernate 交 的 异常 简单 , 如 下 所 示 ， 一 行 代码 就 可 以 搞 
E: 


SessionFactory sf = new Configuration().configure().buildSessionFac 
‘| _ | Z] 
你 可 以 使 用 如 下 代码 来 添加 一 个 不 同 的 XML 配置 文件 








SessionFactory sf = new Configuration() 
.configure("catdb.cfg. xml") 
.buildSessionFactory(); 


3.8. J2EE 应 用 程序 服务 器 的 集成 


针对 J2EE 体 系 ,Hibernate 有 如 下 几 个 集成 的 方面 : 


容器 管理 的 数据 源 (Container-managed datasources): Hibernate 能 使 用 通过 容 
器 管理 ， 并 由 JNDI 提 供 的 JDBC 连 接 . 通常 , 特别 是 当 人 处 理 多 个 数据 源 的 分 布 式 
事务 的 时 候 , 由 一 个 JTA 兼 容 的 TransactionManager 和 一 个 

ResourceManager 来 处 理事 务 管理 (CMT, 容器 管理 的 事务 ). 当然 你 可 以 通过 
编程 方式 来 划分 事务 边界 (BMT, Bean 管理 的 事务 ). 或 者 为 了 代码 的 可 移植 性 ， 
你 也 也 许 会 想 使 用 可 选 的 Hibernate Transaction API. 


EB a JNDIZ FE: Hibernate 可 以 在 启动 后 将 SessionFactory 绑 定 到 JNDI. 


JTA Session 绑 定 : Hibernate Session 可 以 自动 绑 定 到 JTA 事 务 作 用 的 范围 . 
只 需 简 单 地 从 JNDI 查 找 SessionFactory 并 获得 当前 的 Session . 当 JTA 事 
务 完成 时 , 让 Hibernate 来 处 理 session 的 清洗 (flush) 与 关闭 . 事务 的 划分 可 以 
是 声明 式 的 (CMT), 也 可 以 是 编程 式 的 (BMT/UserTransaction). 


JMX 部 署 : 如 果 你 使 用 支持 JMX 应 用 程序 服务 器 (如 , JBoss AS), 那么 你 可 以 选 
择 将 Hibernate 部 署 成 托管 MBean. 这 将 为 你 省 去 一 行 从 configuration 构 
建 SessionFactory 的 启动 代码 . 容器 将 启动 你 的 HibernateService , 并 完 
E 的 依赖 关系 (Hibernate 和 启动 前 ， 数 据 源 必 须 是 可 用 的 ， 等 
E), 


如 果 应 用 程序 服务 器 抛 出 "connection containment", 根据 你 的 环境 ， 也 许 该 将 


配置 属性 hibernate.connection.release_mode 设 为 after_statement . 


3.8.1. 事务 策略 配 什 


在 你 的 架构 中 ，Hibernate 的 session API 是 独立 于 任何 事务 分 界 系统 的 . 如 果 你 
让 Hibernate 通 过 连接 池 直 接 使 用 JDBC, 你 需要 调用 JDBC API 来 打开 和 关闭 你 的 事 
务 . 如 果 你 运行 在 J2EE 应 用 程序 服务 器 中 , 你 也 许 想 用 Bean 管 理 的 事务 并 在 需要 的 
时 候 调 用 JTA API 和 UserTransaction . 


为 了 让 你 的 代码 在 两 种 (或 其 他 ) 环 境 中 可 以 移植 ， 我 们 建议 使 用 可 选 的 Hibernate 
Transaction API, 它 包 装 并 隐藏 了 底层 系统 . 你 必须 通过 设置 Hibernate 配 置 属 
性 hibernate.transaction.factory_class 来 指定 一 个 Transaction 实例 的 
工厂 类 . 

有 三 个 标准 (内 建 ) 的 选择 : 
org.hibernate.transaction.JDBCTransactionFactory 


委托 给 数据 库 (JDBC) 事 务 (默认 ) 


org.hibernate.transaction.JTATransactionFactory 


如 果 在 上 下 文 环境 中 存在 运行 着 的 事务 (如 , EJB 会 话 Bean 的 方法 ), 则 委托 给 容器 管 
理 的 事务 , 否则 ， 将 和 启动 一 个 新 的 事务 ， 并 使 用 Bean 管 理 的 事务 . 


org.hibernate.transaction.CMTTransactionFactory 
委托 给 容器 管理 的 JTA 事 务 
你 也 可 以 定义 属于 你 自己 的 事务 策略 (如 , 针对 CORBA 的 事务 服务 ) 


Hibernate 的 一 些 特 性 (比如 二 级 缓存 , Contextual Sessions with JTA 等 等 ) 需 要 访问 
在 托管 环境 中 的 JTA TransactionManager . 由 于 J2EE 没 有 标准 化 一 个 单一 的 机 
制 ,Hibernate 在 应 用 程序 服务 器 中 ， 你 必须 指定 Hibernate 如 何 获 


得 TransactionManager 的 引用 : 


表 3.10. JTA TransactionManagers 


org 


org. 


org. 


org. 


org. 


org. 


org 


org. 


org 


org. 


. hibernate. 


hibernate 


hibernate. 


hibernate. 


hibernate. 
hibernate. 
.hibernate. 
hibernate. 
„hibernate. 


hibernate. 


Transaction 工 厂 类 


transaction. 


. transaction 


transaction 


transaction 


transaction 


transaction. 
transaction. 
transaction. 
transaction. 


transaction. 


JBossTransactionManagerLookup 


.WeblogicTransactionManagerLookup 


.WebSphereTransact ionManagerLookup 
.WebSphereExtendedJTATransactionLookup 


.OrionTransactionManagerLookup 


ResinTransactionManagerLookup 
JOTMTransactionManagerLookup 

JOnASTransactionManagerLookup 
JRun4TransactionManagerLookup 


BESTransactionManagerLookup 


3.8.2. JNDI 绑 定 的 SessionFactory 


与 JNDI 绑 定 的 Hibernate 的 SessionFactory 能 简化 工厂 的 查询 ， 简 化 创建 新 
的 Session . 需要 注意 的 是 这 与 JNDI 绑 定 Datasource 没有 关系 , 它们 只 是 恰巧 
用 了 相同 的 注册 表 ! 


如 果 你 希望 将 SessionFactory 绑 定 到 一 个 JNDI 的 名 字 空间 , AB 

性 hibernate.session_factory_name 指定 一 个 名 字 ( 如 ， 
java:hibernate/SessionFactory ). 如 果 不 设 置 这 个 属性 ， 

SessionFactory 将 不 会 被 绑 定 到 JNDI 中 . (在 以 只 读 JND| 为 默认 实现 的 环境 中 ， 
这 个 设置 尤其 有 用 , 如 Tomcat.) 


在 将 SessionFactory 绑 定 至 JNDI 时 , Hibernate 将 使 用 hibernate.jndi.url , 
和 hibernate.jndi.class 的 值 来 实例 化 初始 环境 (initial context). 如 果 它 们 没有 
被 指定 , 将 使 用 默认 的 Initialcontext . 


在 你 调用 cfg.buildSessionFactory() 后 , Hibernate 会 自动 

将 SessionFactory 注册 到 JNDI. 这 意味 这 你 至 少 需要 在 你 点 用 程序 的 启动 代码 
(或 工具 类 ) 中 完成 这 个 调用 , 除非 你 使 用 HibernateService 来 做 JMX 部 署 ( 见 后 
面 讨论 ). 


假若 你 使 用 JNDI SessionFactory ,EJB 或 者 任何 其 它 类 都 可 以 从 JNDI 中 找到 


此 SessionFactory 。 


我 们 建议 ， 在 受 管理 的 环境 中 ， 把 sessionFactory 绑 定 到 JNDI， 在 其 它 情 况 
下 ， 使 用 一 个 static( 静 态 的 ) singleton。 为 了 在 你 的 应 用 程序 代码 中 隐藏 这 些 细 
节 ， 我 们 还 建议 你 用 一 个 helper 类 把 实际 查找 SessionFactory 的 代码 隐藏 起 来 ， 
比如 HibernateUtil.getSessionFactory() 。 注 意 ， 这 个 类 也 就 可 以 方便 地 所 
动 Hibernate， 参 见 第 一 章 。 


3.8.3. 在 JTA 环 境 下 使 用 Current Session context 
(当前 session 上 下 文 ) 管 理 


在 Hibernate 中 ， 管 理 session 和 transaction 最 好 的 方法 是 自动 的 " 当 

BU" Session 管理 。 请 参见 第 2.5 节 “ 上 下 文 相 关 的 (Contextual) Session” 一 节 的 
讨论 。 使 用 "jta" session 上 下 文 ， 假 若 在 当前 JTA 事 务 中 还 没有 

Hibernate Session 关联 ， 第 一 次 sessionFactory.getCurrentSession() 调用 
会 启动 一 个 Session, 并 关联 到 当前 的 JTA 事 务 。 在 "jta" 上 下 文中 调 

FA getCurrentSession() 获得 的 Session ， 会 被 设置 为 在 transaction 关 闭 的 时 
候 自 动 flush Gait) 、 在 transaction 关 闭 之 后 自动 关闭 ， 每 句 语句 之 后 主动 释放 
JDBC 连 接 。 这 就 可 以 根据 JTA 事 务 的 生命 周期 来 管理 与 之 关联 的 Session, AP 
代码 中 就 可 以 不 再 考虑 这 些 管理 。 你 的 代码 也 可 以 通过 UserTransaction 用 编程 
方式 使 用 JTA， 或 者 (我 们 建议 ， 为 了 便于 移植 代码 ) 使 用 Hibernate 

的 Transaction API 来 设置 transaction 边 界 。 如 果 你 的 代码 运行 在 EJB 容 器 中 ， 
建议 对 CMT 使 用 声明 式 事务 声明 。 


3.8.4. JMX 部 署 


为 了 将 SessionFactory 注册 到 JNDI 中 ， cfg.buildSessionFactory() 这 行 代 
码 仍 需 在 某 处 被 执行 . 你 可 在 一 个 static 初始 化 块 ( 像 Hibernateutil 中 的 那 
样 ) 中 执行 它 或 将 Hibernate 部 署 为 一 个 托管 的 服务 . 


为 了 部 署 在 一 个 支持 JMX 的 应 用 程序 服务 器 上 ，Hibernate 和 
org.hibernate.jmx.HibernateService 一 同 分 发 ， 如 Jboss AS. 实际 的 部 署 
和 配置 是 由 应 用 程序 服务 器 提供 者 指定 的 . 这 里 是 JBoss 4.0.x 

的 jboss-service.xml 样 例 : 


<?xml version="1.0"?> 
<server> 


<mbean code="org.hibernate. jmx.HibernateService" 
name="jboss.jca:service=HibernateFactory, name=HibernateFactory' 


<!-- 必须 的 服务 --> 
<depends>jboss.jca:service=RARDeployer</depends> 
<depends>jboss.jca:service=LocalTxCM, name=Hsq1lDS</depends> 


<!-- 将 Hibernate 服 务 绑 定 到 JNDI --> 
<attribute name="JndiName">java:/hibernate/SessionFactory</att) 


<!-- 数据 源 设置 --> 
<attribute name="Datasource">java:HsqlDS</attribute> 
<attribute name="Dialect">org.hibernate.dialect .HSQLDialect</at 


<!-- 事务 集成 --> 
<attribute name="TransactionStrategy"> 

org.hibernate. transaction. JTATransactionFactory</attribute: 
<attribute name="TransactionManagerLookupStrategy"> 

org. hibernate. transaction. JBossTransactionManagerLookup</at 
<attribute name="FlushBeforeCompletionEnabled">true</attribute: 
<attribute name="AutoCloseSessionEnabled">true</attribute> 


<!-- 抓 取 选 项 --> 
<attribute name="MaximumFetchDepth">5</attribute> 


<!-- 二 级 缓存 --> 

<attribute name="SecondLevelCacheEnabled">true</attribute> 
<attribute name="CacheProviderClass">org.hibernate.cache.EhCact 
<attribute name="QueryCacheEnabled">true</attribute> 


<!-- 日 志 --> 
<attribute name="ShowSqlEnabled">true</attribute> 


<!- - 映射 定义 文件 - -> 


<attribute name="MapResources">auction/Item.hbm.xml, auction/Cat 
</mbean> 


</server> 
| 


这 个 文件 是 部 署 在 META-INF 目录 下 的 , 并 会 被 打包 到 以 .sar (service archive) 
为 扩展 名 的 JAR 文 件 中 . 同时 ， 你 需要 将 Hibernate、 它 所 需要 的 第 三 方 库 、 你 编译 
好 的 持久 化 类 以 及 你 的 映射 定义 文件 打包 进 同一 个 文档 . 你 的 企业 Bean( 一 般 为 会 话 
Bean) 可 能 会 被 打包 成 它们 自己 的 JAR 文 件 , 但 你 也 许 会 特 EJB JAR 文 件 一 同 包含 进 
能 独立 ( 热 ) 部 署 的 主 服务 文档 参考 JBoss AS 文 档 以 了 解 更 多 的 JMX 服 务 与 EJB 部 署 
的 信息 . 
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4.3. 实现 equals() 和 hashcode() 

4.4. 动态 模型 (Dynamic models) 

4.5. 元 组 片断 映射 (Tuplizers) 


在 应 用 程序 中 ， 用 来 实现 业务 问题 实体 的 (如 ， 在 电子 商务 应 用 程序 中 的 Customer 
和 Order) 类 就 是 持久 化 类 。 不 能 认为 所 有 的 持久 化 类 的 实例 都 是 持久 的 状态 一 一 
一 个 实例 的 状态 也 可 能 是 瞬时 的 或 脱 管 的 。 


如 果 这 些 持 久 化 类 遵循 一 些 简单 的 规则 ，Hibernate 能 够 工作 得 更 好 ， 这 些 规则 也 被 
称 作 简 单传 统 Java 对 象 (POJO: Plain Old Java Object) 编 程 模型 。 但 是 这 些 规则 并 
不 是 必需 的 。 实际 上 ，Hibernate3 对 于 你 的 持久 化 类 几乎 不 做 任何 设想 。 你 可 以 用 
其 他 的 方法 来 表达 领域 模型 : 比如， 使 用 Map 实例 的 树 型 结构 。 


o o oo 一 


4.1. 一 个 简单 的 POJO 例 子 
大 多 数 Java 程 序 需要 用 一 个 持久 化 类 来 表示 猫 科 动物 。 


package eg; 
import java.util.Set; 
import java.util.Date; 


public class Cat { 
private Long id; // identifier 


private Date birthdate; 
private Color color; 
private char sex; 
private float weight; 
private int litterId; 


private Cat mother; 
private Set kittens = new HashSet(); 


private void setId(Long id) { 
this .id=id; 
} 


public Long getId() { 
return id; 

} 

void setBirthdate(Date date) { 
birthdate = date; 

} 

public Date getBirthdate() { 
return birthdate; 

} 

void setWeight(float weight) { 
this.weight = weight; 

} 

public float getWeight() { 
return weight; 

} 

public Color getColor() { 
return color; 

} 

void setColor(Color color) { 


this.color = color; 
} 


void setSex(char sex) { 


this.sex=sex; 


} 
public char getSex() { 


return sex; 
} 


void setLitterId(int id) { 
this.litterId = id; 
} 


public int getLitterId() { 
return litterId; 
} 


void setMother(Cat mother) { 
this.mother = mother; 
} 


public Cat getMother() { 
return mother; 
} 


void setKittens(Set kittens) { 
this.kittens = kittens; 


public Set getKittens() { 
return kittens; 
} 


// addKitten not needed by Hibernate 

public void addKitten(Cat kitten) { 
kitten.setMother(this); 

kitten.setLitterId( kittens.size() ); 
kittens.add(kitten); 

} 


这 里 要 遵循 四 条 主要 的 规则 : 


4.1.1. 实现 一 个 默认 的 〈 即 无 参数 的 ) 构造 方法 
(constructor) 


Cat 有 一 个 无 参数 的 构造 方法 。 所 有 的 持久 化 类 都 必须 有 一 个 默认 的 构造 方法 
(可 以 不 是 public 的 ) ， 这 样 的 话 Hibernate 就 可 以 使 用 
Constructor.newInstance() 来 实例 化 它们 。 我 们 强烈 建议 ， 在 Hibernate 中 ， 
为 了 运行 期 代理 的 生成 ， 构 造 方 法 至 少 是 包 (package) 内 可 见 的 。 


4.1.2. 提供 一 个 标识 属性 (identifier property) 
(可 选 ) 


Cat 有 一 个 属性 叫做 id 。 这 个 属性 映射 数据 库 表 的 主 键 字段 。 这 个 属性 可 以 叫 
任何 名 字 ， 其 类 型 可 以 是 任何 的 原始 类 型 、 原 始 类 型 的 包装 类 型 、 
java.lang.String 或 者 是 java.util.Date, (如 果 你 的 遗留 数据 库 表 有 联 
合 主键 ， 你 甚至 可 以 用 一 个 用 户 自 定义 的 类 ， 该 类 拥有 这 些 类 型 的 属性 。 参 见 后 面 
的 关于 联合 标识 符 的 章节 。 ) 


标识 符 属 性 是 可 选 的 。 可 以 不 用 管 它 ， 让 Hibernate 内 部 来 追踪 对 象 的 识别 。 但 是 
我 们 并 不 推荐 这 样 做 。 

实际 上 ， 一 些 功能 只 对 那些 声明 了 标识 符 属性 的 类 起 作用 : 

。 托管 对 象 的 传播 性 再 连接 (级 联 和 更 新 或 级 联合 并 ) 


播 性 持久 化 (transitive persistence)” 
e Session.saveOrUpdate( ) 


参阅 + 第 10.11 节 “ 传 





e Session.merge() 


我 们 建议 你 对 持久 化 类 声明 命名 一 致 的 标识 属性 。 我 们 还 建议 你 使 用 一 个 可 以 为 空 
(也 就 是 说 ， 不 是 原始 类 型 ) 的 类 型 。 


4.1.3. 使 用 非 final 的 类 (可 选 ) 


代理 (proxies) 是 Hibernate 的 一 个 重要 的 功能 ， 它 依赖 的 条 件 是 ， 持 久 化 类 或 者 
是 非 final 的 ， 或 者 是 实现 了 一 个 所 有 方法 都 声明 为 public 的 接口 。 


你 可 以 用 Hibernate 持 久 化 一 个 没有 实现 任何 接口 的 final 类 ， 但 是 你 不 能 使 用 代 
理 来 延迟 关联 加 载 ， 这 会 限制 你 进行 性 能 优化 的 选择 。 


你 也 应 该 避免 在 非 final 类 中 声明 public final 的 方法 。 如 果 你 想 使 用 一 
有 public final 方法 的 类 ， 你 必须 通过 设置 lazy="false" Sena wise raft 
理 。 


4.1.4. 为 持久 化 字段 声明 访问 器 (accessors) 和 是 否 
可 变 的 标志 (mutators)( 可 选 ) 


Cat 为 它 的 所 有 持久 化 字段 声明 了 访问 方法 。 很 多 其 他 ORM 工 具 直 接 对 实例 变量 
进行 持久 化 。 我 们 相信 ， 在 关系 数据 库 schema 和 类 的 内 部 数据 结构 之 间 引 入 间接 

层 ( 原 文 为 " 非 直接 "，indirection) 会 好 一 些 。 默 认 情 况 下 Hibernate 持 久 化 JavaBeans 
风格 的 属性 ， 认 可 getFoo ， isFoo 和 setFoo 这 种 形式 的 方法 名 。 如 果 需 

要 ， 你 可 以 对 某 些 特定 属性 实行 直接 字段 访问 。 


属性 不 需要 要 声明 为 public 的 。Hibernate 可 以 持久 化 一 个 有 
default 、 protected 或 private 的 get/set 方 法 对 的 属性 进行 持久 化 。 


TODO : property 和 proxy 包 里 的 用 户 扩 展 框 架 文档 。 


4.2. 实现 继承 (Inheritance) 
子 类 也 必须 遵守 第 一 条 和 第 二 条 规则 。 它 从 超 类 Cat 继承 了 标识 属性 。 


package eg; 


public class DomesticCat extends Cat { 
private String name; 


public String getName() { 
return name; 


protected void setName(String name) { 
this .name=name; 
} 


4.3. 实现 equals() 和 hashcode() 


如 果 你 有 如 下 需求 ， 你 必须 重 载 equals() 和 hashCode() 方法 : 
e 想 把 持久 类 的 实例 放 入 set 中 〈 当 表示 多 值 关 联 时 ， 推 荐 这 人 么 做 ) 
e 想 重 用 脱 管 实例 


Hibernate 保 证 ， 仅 在 特定 会 话 范围 内 ， 持 久 化 标识 (数据 库 的 行 ) 和 Java 标 识 是 
等 价 的 。 因 此 ， 一 旦 我 们 混合 了 从 不 同 会 话 中 获取 的 实例 ， 如 果 希 望 Set 有 明确 
的 语义 ， 就 必 须 实现 equals() 和 hashcode() 。 


实现 equals() / hashcode() 最 显而易见 的 方法 是 比较 两 个 对 象 标识 符 的 值 。 如 
果 值 相同 ， 则 两 个 对 象 对 应 于 数据 库 的 同一 行 ， 因 此 它们 是 相等 的 《如果 都 被 添加 
到 Set ， 则 在 Set 中 只 有 一 个 元 素 ) 。 不 幸 的 是 ， 对 生成 的 标识 不 能 使 用 这 种 
方法 。Hibernate 仅 对 那些 持久 化 对 象 赋 标 识 值 ， 一 个 新 创建 的 实例 将 不 会 有 任何 标 
识 值 。 此 外 ， 如 果 一 个 实例 没有 被 保存 (unsaved)， 并 且 它 当前 正在 一 个 Set 中 ， 

保存 它 将 会 给 这 个 对 象 赋 一 个 标识 值 。 如 果 equals() 和 hashcode() 是 基于 

标识 值 实现 的 ， 则 其 哈 希 码 将 会 改变 ， 这 违反 了 set 的 契约 。 建 议 去 Hibernate 的 
站 点 阅读 关于 这 个 问题 的 全 部 讨论 。 注 意 ， 这 不 是 Hibernate 的 问题 ， 而 是 一 般 的 

Java 对 象 标 识 和 Java 对 象 等 价 的 语义 问题 。 

我 们 建议 使 用 业务 键 值 相等 (Business key equality) XH, equals() 和 


hashCode() 。 业 务 键 值 相 等 的 意思 是 ， equals() 方法 仅仅 比较 形成 业务 键 的 
属性 ， 它 能 在 现实 世界 里 标识 我 们 的 实例 (是 一 个 自然 的 候选 码 ) 。 


public class Cat { 


public boolean equals(Object other) { 
if (this == other) return true; 
if ( !(other instanceof Cat) ) return false; 


final Cat cat = (Cat) other; 


if ( !cat.getLitterId().equals( getLitterId() ) ) return fé 
if ( !cat.getMother().equals( getMother() ) ) return false, 


return true; 


} 


public int hashCode() { 
int result; 
result = getMother().hashCode(); 
result = 29 * result + getLitterId(); 
return result; 





注意 ， 业 务 键 不 必 像 数据 库 的 主键 那样 固定 不 变 (参见 第 11.1.3 节 “ 天 注 对 象 标识 
(Considering object identity)”) 。 对 业务 键 而 言 ， 不 可 变 或 唯一 的 属性 是 不 错 的 选 


择 。 


4.4. 动态 模型 (Dynamic models) 


注意 ， 以 下 特性 在 当前 处 于 试验 阶段 ， 将 来 可 能 会 有 变化 。 


运行 期 的 持久 化 实体 没有 必要 一 定 表示 为 像 POJO 类 或 JavaBean 对 象 那样 的 形式 。 
Hibernate 也 支持 动态 模型 (在 运行 期 使 用 Map 的 map ) 和 象 DOM4J 的 树 模型 那 
样 的 实体 表示 。 使 用 这 种 方法 ， 你 不 用 写 持 久 化 类 ， 只 宇 映 射 文件 就 行 了 。 


Hibernate 默 认 工 作 在 普通 POJO 模 式 。 你 可 以 使 用 配置 选 
项 default_entity_mode , 对 特定 的 SessionFactory ， 设 置 一 个 默认 的 实体 
表示 模式 。 (参见 表 3.3 “Hibernate 配置 属性 ”。) 


下 面 是 用 Map 来 表示 的 例子 。 首 先 ， 在 映射 文件 中 ， 要 声明 entity-name 来 代 
蔡 一 个 类 名 (或 作为 一 种 附属 ) 。 


<hibernate-mapping> 
<class entity-name="Customer'"> 


<id name="id" 

type="long" 

column="ID"> 

<generator class="Ssequence"/> 
</id> 


<property name="name" 
column="NAME" 
type="string"/> 


<property name="address" 
column="ADDRESS" 
type="string"/> 


<many-to-one name="organization" 
column="ORGANIZATION_ID" 
class="Organization"/> 


<bag name="orders" 
inverse="true" 
lazy="false" 
cascade="all"> 
<key column="CUSTOMER_ID"/> 
<one-to-many class="Order"/> 
</bag> 


</class> 


</hibernate-mapping> 


注意 ， 虽 然 是 用 目标 类 名 来 声明 关联 的 ， 但 是 关联 的 目标 类 型 除了 是 POJO 之 外 ， 
也 可 以 是 一 个 动态 的 实体 。 


在 使 用 dynamic-map 为 SessionFactory 设置 了 默认 的 实体 模式 之 后 ， 可 以 在 
运行 期 使 用 Map 的 Map 。 


Session s = openSession(); 
Transaction tx = s.beginTransaction(); 
Session s = openSession(); 


// Create a customer 
Map david = new HashMap(); 
david.put("name", "David"); 


// Create an organization 
Map foobar = new HashMap(); 
foobar.put("name", "Foobar Inc."); 


// Link both 
david.put("organization", foobar); 


// Save both 
s.save( "Customer", david); 
s.save( "Organization", foobar); 


tx.commit(); 
s.close(); 


动态 映射 的 好 处 是 ， 变 化 所 需要 的 时 间 少 了 ， 因 为 原型 不 需要 实现 实体 类 。 然 

你 无 法 进行 编译 期 的 类 型 检查 ， 并 可 能 由 此 会 处 理 很 多 的 运行 期 异常 。 
Hibernate 映 射 ， 它 使 得 数 据 库 的 schema 能 容易 的 规格 化 和 合理 化 ， 并 允许 稍 后 在 
此 之 上 添加 合适 的 领域 模型 实现 。 


实体 表示 模式 也 能 在 每 个 Session 的 基础 上 设置 


Session dynamicSession = pojoSession.getSession(EntityMode.MAP) ; 


// Create a customer 

Map david = new HashMap(); 
david.put("name", "David"); 
dynamicSession.save("Customer", david); 


dynamicSession.flush(); 
dynamicSession.close() 


// Continue on pojoSession 


请 注意 ， 用 EntityMode 调用 getSession() 是 在 Session 的 API 中 ， 而 不 

是 SessionFactory 。 这 样 ， 新 的 Session 共享 底层 的 JDBC 连 接 ， 事 务 ， 和 其 
他 的 上 下 文 信 息 。 这 意味 着 ， 你 不 需要 在 第 二 个 Session 中 调用 

flush() 和 close() ， 同 样 的 ， 把 事务 和 连接 的 处 理 交 给 原来 的 工作 单元 。 


关于 XML 表示 能 力 的 更 多 信息 可 以 在 第 18 章 XML 映射 中 找到 。 


4.5. 元 组 片断 映射 (Tuplizers) 


org.hibernate.tuple.Tuplizer ， 以 及 其 子 接口 ， 负 责 根据 给 定 

的 org.hibernate.EntityMode ， 来 复 现 片断 数据 。 如 果 给 定 的 片断 数据 被 认为 
其 是 一 种 数据 结构 ，"tuplizer" 就 是 一 个 知道 如 何 创建 这 样 的 数据 结构 ， 以 及 如 何 给 
这 个 数据 结构 赋值 的 东西 。 比 如 说 ， 对 于 POJO 这 种 Entity Mode， 对 应 的 tuplizer 知 
道 通过 其 构造 方法 来 创建 一 个 POJO， 再 通过 其 属性 访问 器 来 访问 POJO 属 性 。 有 
两 大 类 高 层 Tuplizer， 分 别 是 org.hibernate.tuple.entity.EntityTuplizer 
和 org. hibernate.tuple.entity.ComponentTuplizer 接 

OH. EntityTuplizer 负责 管理 上 面 提 到 的 实体 的 契约 ， 

而 ComponentTuplizer 则 是 针对 组 件 的 。 


用 户 也 可 以 插入 其 自 定义 的 tuplizer。 或 许 您 需要 一 种 不 同 于 dynamic-map entity- 
mode 中 使 用 的 java.util.HashMap 的 java.util.Map 实现 ; 或 许 您 需要 与 默 
认 策 略 不 同 的 代理 生成 策略 (proxy generation strategy)。 通 过 自 定义 tuplizer 实 现 ， 
这 两 个 目标 您 都 可 以 达到 。Tuplizer 定 义 被 附加 到 它们 期 望 管理 的 entity 或 者 
component 映 射 中 。 回 到 我 们 的 customer entity 例 子 : 


<hibernate-mapping> 
<class entity-name="Customer"> 

Alas 
Override the dynamic-map entity-mode 
tuplizer for the customer entity 

T 

<tuplizer entity-mode="dynamic-map" 

class="CustomMapTuplizerImp1"/> 


<id name="id" type="long" column="ID"> 
<generator class="Ssequence"/> 
</id> 


<!-- other properties --> 
</class> 
</hibernate-mapping> 
public class CustomMapTuplizeriImpl 
extends org.hibernate.tuple.entity.DynamicMapEntityTuplizet 
// override the buildInstantiator() method to plug in our cust¢ 
protected final Instantiator buildInstantiator ( 


org.hibernate.mapping.PersistentClass mappingInfo) { 
return new CustomMapInstantiator( mappingInfo ); 


} 


private static final class CustomMapInstantiator 
extends org.hibernate.tuple.DynamicMapInstantitor { 
// override the generateMap() method to return our custom r 
protected final Map generateMap() { 
return new CustomMap(); 
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5.1. 映射 定义 (Mapping declaration) 


对 象 和 关系 数据 库 之 间 的 映射 通常 是 用 一 个 XML 文档 (XML document) 来 定义 的 。 
这 个 映射 文档 被 设计 为 易 读 的 ， 并 且 可 以 手工 修改 。 映 射 语言 是 以 Java 为 中 心 ， 这 
意味 着 映射 文档 是 按照 持久 化 类 的 定义 来 创建 的 ， 而 非 表 的 定义 。 


请 注意 ， 哩 然 很 多 Hibernate 用 户 选择 手写 XML 映 射 文档 ， 但 也 有 一 些 工具 可 以 用 来 
生成 映射 文档 ， 包括 XDoclet,Middlegen 和 AndroMDA。 


让 我 们 从 一 个 映射 的 例子 开始 : 


<?xml version="1.0"?> 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://hibernate.sourceforge.net/hibernate-mapping-3.0.¢ 


<hibernate-mapping package="eg"> 


<class name="Cat" 
table="cats" 
discriminator -value="C"> 


<id name="id"> 
<generator class="native"/> 
</id> 


<discriminator column="subclass" 
type="character"/> 


<property name="weight"/> 


<property name="birthdate" 
type="date" 
not-null="true" 
update="false"/> 


<property name="color" 
type="eg.types.ColorUserType" 
not-null="true" 
update="false"/> 


<property name="sex" 
not-null="true" 
update="false"/> 


<property name="litterId" 
column="litterId" 
update="false"/> 


<many-to-one name="mother" 
column="mother_id" 
update="false"/> 


<set name="kittens" 
inverse="true" 
order -by="litter_id"> 
<key column="mother_id"/> 
<one-to-many class="Cat"/> 
</set> 


<subclass name="DomesticCat" 
discriminator -value="D"> 


<property name="name" 
type="string"/> 


</subclass> 
</class> 
<class name="Dog"> 


<!-- mapping for Dog could go here --> 
</class> 


</hibernate-mapping> 





我 们 现在 开始 讨论 映射 文档 的 内 容 。 我 们 只 描述 Hibernate 在 运行 时 用 到 的 文档 元 素 
和 属性 。 映射 文档 还 包括 一 些 额 外 的 可 选 属性 和 元 素 ， 它 们 在 使 用 schema 导 出 工 
具 的 时 候 会 影响 导出 的 数据 库 schema 结 果 。 (比如 ， not-null 属性 。) 


5.1.1. Doctype 


所 有 的 XML 映射 都 需要 定义 如 上 所 示 的 doctype。DTD 可 以 从 上 述 URL 中 获取 ， 也 
可 以 从 hibernate-x.x.x/src/net/sf/hibernate 目录 中 、 

或 hibernate.jar 文件 中 找到 。Hibernate 总 是 会 首先 在 它 的 classptah 中 搜索 
DTD 文 件 。 如 果 你 发 现 它 是 通过 连接 Internet 查 找 DTD 文 件 ， 就 对 照 你 的 classpath 
目录 检查 XML 文件 里 的 DTD 声 明 。 


5.1.1.1. EntityResolver 


As mentioned previously, Hibernate will first attempt to resolve DTDs in its 
classpath. The manner in which it does this is by registering a custom 

org.xml.sax.EntityResolver implementation with the SAXReader it uses to 
read in the xml files. This custom EntityResolver recognizes two different 
systemld namespaces. 如 前 所 述 ,Hibernate 首 先 在 其 LE ade alas 其 行为 
是 依靠 在 系统 中 注册 的 org .xml. aa EntityResolver 的 一 具体 实现 ， 
SAXReader 依 靠 它 来 读 取 xml 文 件 。 这 一 EntityResolver ea EHR FR RD AR [al 
的 systenld 命 名 空间 。 


e 若 resolver 遇 到 了 一 个 以 http://hibernate.sourceforge.net/ 为 开头 的 
systemld， 它 会 辨认 出 是 hibernate namespace ，resolver 就 试图 通过 加 载 
Hibernate 类 的 classloader 来 查找 这 些 实体 。 


e 若 resolver 遇 到 了 一 个 使 用 classpath:// URL 协 议 的 systemld， 它 会 辨认 出 
这 是 user namespace ,resolver 试 图 通过 (1) 当 前 线程 上 下 文 的 classloader 和 
(2) 加 载 Hibernate class 的 classloader 来 查找 这 些 实体 。 


使 用 user namespace( 用 户 命名 空间 ) 的 例子 


<?xml version="1.0"?> 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dt¢ 
<!ENTITY types SYSTEM "classpath://your/domain/types. xmL"> 
] > 


<hibernate-mapping package="your .domain"> 
<class name="MyEntity"> 
<id name="id" type="my-custom-id-type"> 


</id> 
<class> 
&types,; 
</hibernate-mapping> 


i 


types.xml 是 your.domain 包 中 的 一 个 资源 ， 它 包含 了 一 个 定制 的 第 5.2.3 节 
“ 自 定义 值 类 型 ”。 





5.1.2. hibernate-mapping 


这 个 元 素 包 括 一 些 可 选 的 属性 。 schema 和 catalog 属性 ， 指明 了 这 个 映射 所 连 
接 (refer) 的 表 所 在 的 schema 和 /或 catalog 名 称 。 假若 指定 了 这 个 属性 ， 表 名 会 加 
上 所 指定 的 schema 和 catalog 的 名 字 扩 展 为 全 限定 名 。 假 若 没有 指定 ， 表 名 就 不 会 

使 用 全 限定 名 。 default-cascade 指定 了 未 明确 注 明 cascade 属性 的 Java 属 性 
和 集合 类 Hibernate 会 采取 什么 样 的 默认 级 联 风 格 。 auto-import 属性 默认 让 我 

们 在 查询 语言 中 可 以 使 用 非 全 限定 名 的 类 名 。 


<hibernate-mapping 
schema="schemaName" 
catalog="catalogName" 
default -cascade="cascade_style" 
default -access="field|property|ClassName" 
default -lazy="true| false" 
auto-import="true|false" 
package="package.name" 

/> 


© schema (可 选 ): 数据 库 schema 的 名 称 。 
catalog (可 选 ): 数据 库 catalog 的 名 称 。 
© default-cascade (可 选 -默认 为 none ): 默认 的 级 联 风 格 。 


© 


default-access (可 选 - 默认 为 property ): Hibernate 用 来 访问 所 有 属 
性 的 策略 。 可 以 通过 实现 PropertyAccessor 接口 自 定义 。 


default-lazy (可 选 - 默认 为 true ): 指定 了 未 明确 注 明 lazy 属性 的 
Java 属 性 和 集合 类 ， Hibernate 会 采取 什么 样 的 默认 加 载 风格 。 


auto-import (可 选 - 默认 为 true ): 指定 我 们 是 否 可 以 在 查询 语言 中 使 
用 非 全 限定 的 类 名 ( 仅 限 于 本 映射 文件 中 的 类 ) 。 


package (可 选 ): 指定 一 个 包 前 级 ， 如 果 在 映射 文档 中 没有 指定 全 限定 的 类 
名 ， 就 使 用 这 个 作为 包 名 。 


假若 你 有 两 个 持久 化 类 ， 它 们 的 非 全 限定 名 是 一 样 的 〈 就 是 两 个 类 的 名 字 一 样 ， 所 
在 的 包 不 一 样 -- 译 者 注 ) ， 你 应 该 设置 auto-import="false" 。 如 果 你 把 一 
个 “import 过 ”的 名 字 同 时 对 应 两 个 类 ， Hibernate 会 抛 出 一 个 异常 。 


注意 hibernate-mapping 元 素 允 许 你 找 套 多 个 如 上 所 示 的 &lt;class&gt; BR 
射 。 但 是 最 好 的 做 法 (也许 一 些 工具 需要 的 ) 是 一 个 持久 化 类 (或 一 个 类 的 继承 层 
次 ) 对 应 一 个 映射 文件 ， 并 以 持久 化 的 超 类 名 称 命名 ， 例如: cat.hbm.xml , 
Dog.hbm.xml ， 或 者 如 果 使 用 继承 ， Animal.hbm.xml 。 


Q 


5.1.3. 


class 


你 可 以 使 用 class 元 素来 定义 一 个 持久 化 类 : 


<class 


/> 


name="ClassName" 

table="tableName" 

discriminator -value="discriminator_value" 
mutable="true| false" 

schema="owner" 

catalog="catalog" 
proxy="ProxyInter face" 

dynamic -update="true|false" 

dynamic -insert="true|false" 
select-before-update="true|false" 
polymorphism="implicit |explicit" 
where="arbitrary sql where condition" 
persister="PersisterClass" 
batch-size="N" 
optimistic-lock="none|version|dirty|all" 
lazy="true|false" 
entity-name="EntityName" 
check="arbitrary sql check condition" 
rowid="rowid" 

subselect="SQL expression" 
abstract="true|false" 

node="element -name" 


name (可 选 ): 持久 化 类 (或 者 接口 ) 的 Java 全 限定 名 。 如 果 这 个 属性 
不 存在 ，Hibernate 将 假定 这 是 一 个 非 POJO 的 实体 映射 。 


table (可 选 - 默认 是 类 的 非 全 限定 名 ): 对 应 的 数据 库 表 名 。 


discriminator-value (可 选 - 默认 和 类 名 一 样 ): 一 个 用 于 区 分 不 同 
的 子 类 的 值 ， 在 多 态 行为 时 使 用 。 它 可 以 接受 的 值 包 括 null 和 


not null . 


mutable (可 选 ， 默 认 值 为 true ): 表明 该 类 的 实例 是 可 变 的 或 者 不 可 
变 的 。 


schema (可 选 ): BRR &lt;hibernate-mapping&gt; 元 素 中 指定 
的 schema 名 字 。 


catalog (可 选 ): 覆盖 在 根 &lt;hibernate-mapping&gt; 元 素 中 指 
定 的 catalog 名 字 。 


proxy (可 选 ): 指定 一 个 接口 ， 在 延迟 装载 时 作为 代理 使 用 。 你 可 以 在 


(17) 


(18) 


(19) 


(20) 


这 里 使 用 该 类 自己 的 名 字 。 


dynamic-update (可 选 , 默认 为 ” false ): 指定 用 于 UPDATE 的 SQL 
将 会 在 运行 时 动态 生成 ， 并 且 只 更 新 那些 改变 过 的 字段 。 


dynamic-insert (可 选 , 默认 为 ”false ): 指定 用 于 INSERT 的 SQL 
将 会 在 运行 时 动态 生成 ， 并 且 只 包含 那些 非 空 值 字段 。 


select-before-update (可 选 , 默认 为 false ) 指定 Hibernate 除 非 

确定 对 象 真 正 被 修改 了 (如 果 该 值 为 true 一 译注 ) ， 否 则 不 会 执行 SQL 
UPDATE 操作 。 在 特定 场合 (实际 上 ， 它 只 在 一 个 瞬时 对 象 (transient 
object) 关联 到 一 个 新 的 session 中 时 执行 的 update() 中 生效 ) ， 这 说 明 
Hibernate 会 在 UPDATE 之 前 执行 一 次 额外 的 SQL SELECT 操作 ， 来 决 
定 是 否 应 该 执行 UPDATE 。 


polymorphism (多 态 ) (Ali, 默认 值 为 implicit ( 隐 式 ) ): 界定 是 
隐 式 还 是 显 式 的 使 用 多 态 查 询 ( 这 只 在 Hibernate 的 具体 表 继 承 策略 中 用 
一生 

where (可 选 ) 指定 一 个 附加 的 SQL WHERE 条 件 ， 在 抓 取 这 个 类 的 对 
象 时 会 一 直 增 加 这 个 条 件 。 


persister (可 选 ): 指定 一 个 定制 的 ClassPersister 。 


batch-size (可 选 ,默认 是 1 ) 指定 一 个 用 于 根据 标识 符 (identifier) 
抓 取 实 例 时 使 用 的 "batch size”( 批 次 抓 取 数 量 ) 。 


optimistic-lock (乐观 锁定 ) (Fx, FAIA version ): 决定 乐观 
锁定 的 策略 。 


lazy (可 选 ): 通过 设置 lazy="false" , 所 有 的 延迟 加 载 (Lazy 
fetching) 功能 将 被 全 部 禁用 (disabled) 。 


entity-name (可 选 ， 默 认为 类 名 ): Hibernate3 人 允许 一 个 类 进行 多 次 映 
射 〈 前 提 是 映射 到 不 同 的 表 ) ， 并 且 人 允许 使 用 Maps 或 XML 代 蔡 Java 层 
次 的 实体 映射 (也 就 是 实现 动态 领域 模型 ， 不 用 写 持 久 化 类 一 译注 ) 。 
更 多 信息 请 看 第 4.4 节 “ 动 态 模 型 (Dynamic models)’ and 第 18 = XML 
映射 。 


check (可 选 ): 这 是 一 个 SQL 表达 式 ， 用 于 为 自动 生成 的 schema 添 加 
多 行 (multi-row) 约束 检查 。 


rowid (P): Hibernate 可 以 使 用 数据 库 支 持 的 所 谓 的 ROWIDs， 例 
如 : Oracle 数 据 库 ， 如 果 你 设置 这 个 可 选 的 rowid ， Hibernate 可 以 
使 用 额外 的 字段 rowid 实现 快速 更 新 。ROWID 是 这 个 功能 实现 的 重 
点 ， 它 代表 了 一 个 存储 元 组 (tuple) 的 物理 位 置 。 


subselect (可 选 ): 它 将 一 个 不 可 变 (immutable) 并 且 只 读 的 实体 映 
射 到 一 个 数据 库 的 子 查询 中 。 当 你 想 用 视图 代替 一 张 基本 表 的 时 候 ， 这 
是 有 用 的 ， 但 最 好 不 要 这 样 做 。 更 多 的 介绍 请 看 下 面 内 容 。 


abstract (可 选 ): 用 于 在 &1t;union-subclass&gt; 的 继承 结构 


(21) (hierarchies) 中 标识 抽象 超 类 。 


若 指明 的 持久 化 类 实际 上 是 一 个 接口 ， 这 也 是 完全 可 以 接受 的 。 之 后 你 可 以 用 元 
素 &lt;subclassagt; 来 指定 该 接口 的 实际 实现 类 。 你 可 以 持久 化 任何 static( 静 
态 的 ) 内 部 关 。 你 应 该 使 用 标准 的 类 名 格式 来 指定 类 名 ， 比如 : Foo$Bar o 


不 可 变 类 ， mutable="false" 不 可 以 被 应 用 程序 更 新 或 者 删除 。 这 可 以 让 
Hibernate 些小 小 的 性 能 优化 。 


可 选 的 proxy 属性 允许 延迟 加 载 类 的 持久 化 实例 。 Hibernate 开 始 会 返回 实现 了 这 
es 当代 理 的 某 个 方法 被 实际 调用 的 时 候 ， 真实 的 持久 化 对 
象 才 会 被 装载 。 参 见 下 面 的 “用 于 延迟 装载 的 代理 ” 


Implicit ( 隐 式 ) 的 多 态 是 指 ， 如 果 查 询 时 给 出 的 是 任何 超 类 、 该 类 实现 的 接口 或 者 该 
类 的 名 字 ， 都 会 返回 这 个 类 的 实例 ; 如 果 查 询 中 给 出 的 定子 类 的 名 字 ， 则 会 返回 子 
类 的 实例 。 Explicit ( 显 式 ) 的 多 态 是 指 ， 只 有 在 查询 时 给 出 明确 的 该 ; 类 名 字 时 才 
会 返回 这 个 类 的 实例 ; 同时 只 有 在 这 个 &lt;class&gt; 的 定义 中 作 

为 &lt;subclass&gt; 或 者 &lt;joined-subclass&gt; 出 现 的 子 类 ， 才 会 可 能 
返回 。 在 大 多 数 情况 下 ， 默 认 的 polymorphism="implicit" 都 是 合适 的 。 显 式 
的 多 态 在 有 两 个 不 同 的 类 映射 到 同一 个 表 的 时 候 很 有 用 。 (人 允许 一 个 “轻型 "的 类 ， 
只 包含 部 分 表 字 段 ) 。 

persister 属性 可 以 让 你 定制 这 个 类 使 用 的 持久 化 策略 。 你 可 以 指定 你 自己 实现 
org. pe persister.EntityPersister 的 子 类 ， 你 甚至 可 以 完全 从 头 开 
始 编写 一 个 org. Hine paceman oie cer cles cpoueuacoR 接口 的 实现 ， 比如 是 
用 储存 过 ‘ean 序列 化 到 文件 或 者 LDAP 数 据 库 来 实现 。 参 

阅 org.hibernate.test.CustomPersister ， 这 是 一 个 简单 的 例子 (“持久 化 "至 
一 个 Hashtable ) 。 


请 注意 dynamic-update 和 dynamic-insert 的 设置 并 不 会 继承 到 子 类 ， 所 以 
在 &lt;subclass&gt; SX &lt;joined-subclassagt; 元 素 中 可 能 需要 再 次 设 
Bo 这 些 设置 是 否 能 够 提高 效率 要 视 情形 而 定 。 请 用 你 的 智慧 决定 是 否 使 用 。 


使 用 select-before-update 通常 会 降低 性 能 。 如 果 你 重新 连接 一 个 脱 管 
(detache) 对 象 实例 到 一 个 Session 中 时 ， 它 可 以 防止 数据 库 不 必要 的 触发 
update。 这 就 很 有 用 了 。 


如 果 你 打开 了 dynamic-update ， 你 可 以 选择 几 种 乐观 锁定 的 策略 : 
e version (版 本 检查 ) “检查 version/timestamp 字 段 
e all (全 部 ) ”检查 全 部 字段 
e dirty ( 脏 检 查 ) 只 检察 修改 过 的 字段 
e none (不 检查 ) 不 使 用 乐观 锁定 
我 们 非常 强烈 建议 你 在 Hibernate 中 使 用 version/timestamp 字 段 来 进行 乐观 锁定 。 


对 性 能 来 说 ， 这 是 最 好 的 选择 ， 并 且 这 也 是 唯一 能 够 处 理 在 session 外 进行 操作 的 策 
AS (例如 : 在 使 用 Session.merge() 的 时 候 ) o 


对 Hibernate 映 射 来 说 视图 和 表 是 没有 区 别 的 ， 这 是 因为 它们 在 数据 层 都 是 透明 的 ( 
注意 : 一 些 数据 库 不 支持 视图 属性 ， 特 别 是 更 新 的 时 候 ) 。 有 时 你 想 使 用 视图 ， 但 
却 不 能 在 数据 库 中 创建 它 〈 例 如 : 在 遗留 的 schema 中 ) 。 这 样 的 话 ， 你 可 以 映射 
一 个 不 可 变 的 (immutable) 并 且 是 只 读 的 实体 到 一 个 给 定 的 SQL 子 查询 表达 式 : 


<class name="Summary"> 

<subselect> 
select item.name, max(bid.amount), count(*) 
from item 
join bid on bid.item_id = item.id 
group by item.name 

</subselect> 

<synchronize table="item"/> 

<synchronize table="bid"/> 

<id name="name"/> 


</class> 
定义 这 个 实体 用 到 的 表 为 同步 (synchronize) ， 确 保 自 动 刷 新 (auto-flush) 正确 


执行 ， 并 且 依 赖 原 实体 的 查询 不 会 返回 过 期 数据 。 &1t; subselect&gt; 在 属性 
元 素 和 一 个 艇 套 映射 元 素 中 都 可 见 。 


5.1.4. id 


被 映射 的 类 必须 定义 对 应 数据 库 表 主键 字段 。 大 多 数 类 有 一 个 JavaBeans 风 格 的 属 
性 ， 为 每 一 个 实例 包含 唯一 的 标识 。 &1lt;id&gt; 元 素 定 义 了 该 属性 到 数据 库 表 
主键 字段 的 映射 。 


<id 
name="propertyName" 
type="typename" 
column="column_name" 
unsaved -value="null1|any|none| undefined |id_value" 
access="field|property|ClassName" 
node="element -name|@attribute-name|element/@attribute|."> 
<generator class="generatorClass"/> 
</id> 


© name (Fit): 标识 属性 的 名 字 。 
@ type (可 选 ) 标识 Hibernate 类 型 的 名 字 。 
© column (可 选 - 默认 为 属性 名 ): 主键 字段 的 名 字 。 


unsaved-value (可 选 - 默认 为 一 个 切合 实际 (sensible) 的 值 ): 一 个 特定 

o 的 标识 属性 值 ， 用 来 标志 该 实例 是 刚刚 创建 的 ， 尚 未 保存 。 这 可 以 把 这 种 实 
例 和 从 以 前 的 session 中 装载 过 〈 可 能 又 做 过 修改 -- 译 者 注 ) 但 未 再 次 持久 化 
的 实例 区 分 开 来 。 


© access (可 选 - 默认 为 property ): Hibernate 用 来 访问 属性 值 的 策略 。 
如 果 name 属性 不 存在 ， 会 认为 这 个 类 没有 标识 属性 。 
unsaved-value 属性 在 Hibernate3 中 几乎 不 再 需要 。 


还 有 一 个 另外 的 &lt;composite-id&gt; 定义 可 以 访问 旧式 的 多 主键 数据 。 我 们 
强烈 不 建议 使 用 这 种 方式 。 


5.1.4.1. Generator 


可 选 的 &lt;generatoragt; 子 元 素 是 一 个 Java 类 的 名 字 ， 用 来 为 该 持久 化 类 的 
实例 生成 唯一 的 标识 。 如 果 这 个 生成 器 实例 需要 某 些 配置 值 或 者 初始 化 参数 ， 
用 &lt;paramagt; 元 素来 传递 。 


<id name="id" type="long" column="cat_id"> 
<generator class="org.hibernate.id.TableHiLoGenerator"> 
<param name="table">uid_table</param> 
<param name="column">next_hi_value_column</param> 
</generator> 
</id> 


| 


所 有 的 生成 器 都 实现 org.hibernate.id.IdentifierGenerator 接口 。 这 是 一 
个 非常 简单 的 接口 ; 某 些 应 用 程序 可 以 选择 提供 他 们 自己 特定 的 实现 。 当 然 ， 
Hibernate 提 供 了 很 多 内 置 的 实现 。 下 面 是 一 些 内 置 生成 器 的 快捷 名 字 : 


increment 

用 于 为 long ，short 或 者 int 类 型 生成 唯一 标识 。 只 有 在 没有 其 他 进程 往 同 
一 张 表 中 插入 数据 时 才能 使 用 。 在 集群 下 不 要 使 用 。 

identity 


对 DB2,MySQL, MS SQL Server, Sybase 和 HypersonicSQL 的 内 置 标 识字 段 提 供 支 
持 。 返回 的 标识 符 是 long ，short 或 者 int 类 型 的 。 


sequence 


在 DB2,PostgreSQL, Oracle, SAP DB, McKoi 中 使 用 序列 (sequence), 而 在 
Interbase 中 使 用 生成 器 (generatorn)。 返 回 的 标识 符 是 long ，short 或 者 
int 类 型 的 。 

hilo 


<a class="calibre5 pcalibre pcalibre1" id="mapping-declaration-id- 
hilodescription"></a> 使 用 一 个 高 /低位 算法 高 效 的 生成 long, short 或 者 

int 类 型 的 标识 符 。 给 定 一 个 表 和 字段 (默认 分 别 是 hibernate_unique_key 
和 next_hi ) 作为 高 位 值 的 来 源 。 高 /低位 算法 生成 的 标识 符 只 在 一 个 特定 的 数据 
库 中 是 唯一 的 。 


seqhilo 


使 用 一 个 高 /低位 算法 来 高 效 的 生成 long, short 或 者 int 类 型 的 标识 符 ， 给 
定 一 个 数据 库 序 列 (sequence) 的 名 字 。 


uuid 


用 一 个 128-bit 的 UUID 算 法 生成 字符 串 类 型 的 标识 符 ， 这 在 一 个 网 络 中 是 唯一 的 
(使 用 了 IP 地 址 ) 。UUID 被 编码 为 一 个 32 位 16 进 制 数 字 的 字符 串 。 


guid 
在 MS SQL Server 和 MySQL 中 使 用 数据 库 生 成 的 GUID 字 符 串 。 


native 


根据 底层 数据 库 的 能 力 选 择 identity , sequence 或 者 hilo 中 的 一 个 。 


assigned 


让 应 用 程序 在 save( ) 之 前 为 对 象 分 配 一 个 标示 符 。 这 是 

&lt;generator&gt; 元 素 没有 指定 时 的 默认 生成 策略 。 

select 

通过 数据 库 触 发 器 选择 一 些 唯 一 主键 的 行 并 返回 主键 值 来 分 配 一 个 主键 。 
foreign 

使 用 另外 一 个 相关 联 的 对 象 的 标识 符 。 通 常 和 &lt;one-to-one&gt; 联合 起 来 使 


sequence-identity 


一 种 特别 的 序列 生成 策略 ,使 用 数据 库 序 列 来 生成 实际 值 ,但 将 它 和 JDBC3 的 
getGeneratedKeys 结 合 在 一 起 ,使 得 在 插入 语句 执行 的 时 候 就 返回 生成 的 值 。 目 前 
为 止 只 有 面向 JDK 1.4 的 Oracle 10g 了 驱动 支持 这 一 策略 。 注 意 ， 因 为 Oracle 驱 动 程序 
的 一 个 bug， 这 些 插入 语句 的 注释 被 关闭 了 。 (原文 : Note comments on these 
insert statements are disabled due to a bug in the Oracle drivers.) 


5.1.4.2. 高 /低位 算法 (Hi/Lo Algorithm) 


hilo 和 seqhilo 生成 器 给 出 了 两 种 hi/lo 算 法 的 实现 ， 这 是 一 种 很 伟人 满意 的 
标识 符 生成 算法 。 第 一 种 实现 需要 一 个 “特殊 "的 数据 库 表 来 保存 下 一 个 可 用 
的 “hi" 值 。 第 二 种 实现 使 用 一 个 Oracle 风 格 的 序列 (在 被 支持 的 情况 下 ) 。 


<id name="id" type="long" column="cat_id"> 
<generator class="hilo"> 
<param name="table">hi_value</param> 
<param name="column">next_value</param> 
<param name="max_lo">100</param> 
</generator> 
</id> 


<id name="id" type="long" column="cat_id"> 
<generator class="seqhilo"> 
<param name="sequence">hi_value</param> 
<param name="max_lo">100</param> 
</generator> 
</id> 


很 不 幸 ， 你 在 为 Hibernate 自 行 提 供 Connection 时 无 法 使 用 hilo, 4 
Hibernate 使 用 JTA 获 取 应 用 服务 器 的 数据 源 连 接 时 ,你 必须 正确 地 配置 


hibernate.transaction.manager_lookup_class 。 


5.1.4.3. UUID 算 法 (UUID Algorithm ) 


UUID 包 含 : IP 地 址 ，JVM 的 启动 时 间 (精确 到 1/4 秒 ) ， 系 统 时 间 和 一 个 计数 器 值 
(在 JVM 中 唯一 ) 。 在 Java 代 码 中 不 可 能 获得 MAC 地 址 或 者 内 存 地 址 ， 所 以 这 已 
经 是 我 们 在 不 使 用 JNI 的 前 提 下 的 能 做 的 最 好 实现 了 。 


5.1.4.4. 标识 字段 和 序列 (Identity columns and 
Sequences) 


对 于 内 部 支持 标识 字段 的 数据 库 (DB2,MySQL,Sybase,MS SQL)， 你 可 以 使 

用 identity 关键 字 生成 。 对 于 内 部 支持 序列 的 数据 库 (DB2,Oracle,， 
PostgreSQL, Interbase, McKoi,SAP DB), 你 可 以 使 用 sequence 风格 的 关键 字 生 
成 。 这 两 种 方式 对 于 插入 一 个 新 的 对 象 都 需要 两 次 SQL 查询 。 


<id name="id" type="long" column="person_id"> 
<generator class="sequence"> 
<param name="Sequence">person_id_sequence</param> 
</generator> 
</id> 


a ss SSS 
<id name="id" type="lLong" column="person_id" unsaved-value="0"> 


<generator class="identity"/> 
</id> 


对 于 跨 平 台 开 发 ， native 策略 会 从 identity , sequence 和 hilo 中 进行 选 
择 ， 选 择 哪 一 个 ， 这 取决 于 底层 数据 库 的 支持 能 力 。 


5.1.4.5. 程序 分 配 的 标识 符 (Assigned 
Identifiers) 


如 果 你 需要 应 用 程序 分 配 一 个 标示 符 ( 而 非 Hibernate 来 生成 ) ， 你 可 以 使 

用 assigned 生成 器 。 这 种 特殊 的 生成 器 会 使 用 已 经 分 配给 对 象 的 标识 符 属性 的 
标识 符 值 。 这 个 生成 器 使 用 一 个 自然 键 (natural key， 有 商业 意义 的 列 一 译注 ) 作 
为 主键 ， 而 不 是 使 用 一 个 代理 键 (surrogate key， 没 有 商业 意义 的 列 一 译注 ) 。 这 
是 没有 指定 &1t ;generator&gt; 元 素 时 的 默认 行为 


当选 择 assigned 生成 器 时 ， 除 非 有 一 个 version 或 timestamp 属 性 ， 或 者 你 定义 了 
Interceptor.isUnsaved() ， 否 则 需要 让 Hiberante 使 用 
unsaved-value="undefined" ， 强 制 Hibernatet 坦 询 数据 库 来 确定 一 个 实例 是 瞬 
时 的 (transient) 还 是 脱 管 的 (detached) 。 


5.1.4.6. 触发 器 实现 的 主键 生成 器 (Primary keys 
assigned by triggers) 


仅仅 用 于 遗留 的 Schema 中 (Hibernate 不 能 使 用 触发 器 生成 DDL)。 


<id name="id" type="long" column="person_id"> 
<generator class="Sselect"> 
<param name="key">socialSecurityNumber</param> 
</generator> 
</id> 


在 上 面 的 例子 中 ， 类 定义 了 一 个 命名 为 socialSecurityNumber 的 唯一 值 属性 ， 
它 是 一 个 自然 键 (natural key) ， 命 名 为 person_id 的 代理 键 (surrogate key) 
的 值 由 触发 器 生成 。 


5.1.5. composite-id 


<composite-id 
name="propertyName" 
class="ClassName" 
mapped="true| false" 
access="field|property|ClassName" 
node="element-name]|." 
> 


<key-property name="propertyName" type="typename" column="¢ 
<key-many-to-one name="propertyName class="ClassName" colur 


</composite-id> 
可 = ss 
如 果 表 使 用 联合 主键 ， 你 可 以 映射 类 的 多 个 属性 为 标识 符 属性 。 


&lt;composite-id&gt; 元 素 接受 &lt;key-property&gt; 属性 映射 
和 &1t;key-many-to-one&gt; 属性 映射 作为 子 元 素 。 





<composite-id> 
<key-property name="medicareNumber"/> 
<key-property name="dependent"/> 
</composite-id> 


你 的 持久 化 类 必须 重 载 equals() 和 hashcode() 方法 ， 来 实现 组 合 的 标识 符 的 
相等 判断 。 实现 Serializable 接口 也 是 必须 的 。 


不 幸 的 是 ， 这 种 组 合 关键 字 的 方法 意味 着 一 个 持久 化 类 是 它 自己 的 标识 。 除 了 对 象 
自己 之 外 ， 没有 什么 方便 的 “把手 "可 用 。 你 必须 初始 化 持久 化 类 的 实例 ， 填 充 它 的 
标识 符 属 性 ， 再 load() 组 合 关键 字 关 联 的 持久 状态 。 我 们 把 这 种 方法 称 为 
embedded (#Ast) 的 组 合 标识 符 ， 在 重要 的 应 用 中 不 鼓励 使 用 这 种 用 法 。 


第 二 种 方法 我 们 称 为 mapped( 映 射 式 ) 组 合 标 识 符 (mapped composite 
identifier), &lt;composite-id&agt; 元 素 中 列 出 的 标识 属性 不 但 在 持久 化 类 出 现 ， 
还 形成 一 个 独立 的 标识 符 类 。 


<composite-id class="MedicareId" mapped="true"> 
<key-property name="medicareNumber"/> 
<key-property name="dependent"/> 
</composite-id> 


在 这 个 例子 中 ， 组 合 标识 符 类 MedicareId 和 实体 类 都 含 

有 medicareNumber 和 dependent 属性 。 标 识 符 类 必须 重 

载 equals() 和 hashCode() 并 且 实 现 Serializable 接口 。 这 种 方法 的 缺点 是 
出 现 了 明显 的 代码 重复 。 


下 面 列 出 的 属性 是 用 来 指定 一 个 映射 式 组 合 标识 符 的 : 


e mapped (可 选 , 默认 为 false ): 指明 使 用 一 个 映射 式 组 合 标识 符 ， 其 包含 的 
属性 映射 同时 在 实体 类 和 组 合 标识 符 类 中 出 现 。 


e class (可 选 ,但 对 映射 式 组 合 标识 符 必 须 指 定 ): 作为 组 合 标 识 符 类 使 用 的 类 
名 . 


在 第 8.4 节 “ 组 件 作 为 联合 标识 符 (Components as composite identifiers) 一 节 中 ,我 
们 会 描述 第 三 种 方式 , 那 就 是 把 组 合 标识 符 实现 为 一 个 组 件 (component) 类 ,这 是 更 方 
便 的 方法 。 下 面 的 属性 仅 对 第 三 种 方法 有 效 : 


。 name (可 选 ,但 对 这 种 方法 而 言 必须 ): 包含 此 组 件 标 识 符 的 组 件 类 型 的 名 字 
(Bi BOB). 


e access (可 选 -默认 为 property ): Hibernate 应 该 使 用 的 访问 此 属性 值 的 策 
ag 


e class (可 选 - 默认 会 用 反射 来 自动 判定 属性 类 型 ): 用 来 作为 组 合 标识 符 的 
组 件 类 的 类 名 (参阅 下 一 节 ) 


第 三 种 方式 ， 被 称 为 identifier component( 标 识 符 组 件 ) 是 我 们 对 几乎 折 有 应 用 都 推 
荐 使 用 的 方式 。 


5.1.6. 鉴别 器 (discriminator) 


在 "一 棵 对 象 继承 树 对 应 一 个 表 " 的 策略 中 ，&1t ;discriminator&gt; 元 素 是 必需 
的 , 它 定义 了 表 的 鉴别 器 字段 。 鉴 别 器 字段 包含 标志 值 ， 用 于 告知 持久 化 层 应 该 为 
某 个 特定 的 行 创建 哪 一 个 子 类 的 实例 。 如 下 这 些 受 到 限制 的 类 型 可 以 使 用 : 
string , character , integer , byte , short , boolean , yes_no 
true_false . 


<discriminator 
column="discriminator_column" 
type="discriminator_type" 
force="true|false" 
insert="true|false" 
formula="arbitrary sql expression" 


/> 

© column (可 选 - 默认 为 ”class ) 鉴别 器 字段 的 名 字 

@ type (可 选 -默认 为 string ) 一 个 Hibernate 字 段 类 型 的 名 字 

A force( 强 制 ) (可 选 - 默认 为 false ) "强制 "Hibernate 指 定 允 许 的 鉴别 器 


值 ,即使 当 取 得 的 所 有 实例 都 是 根 类 的 。 

insert (可 选 - 默认 为 true ) 如 果 你 的 鉴别 器 字段 也 是 映射 为 复合 标识 
© (composite identifier) 的 一 部 分 ， 则 需 将 这 个 值 设 为 false. (告诉 
Hibernate 在 做 SQL INSERT 时 不 包含 该 列 ) 

formula (Ait) 一 个 SQL 表达 式 ， 在 类 型 判断 〈 判 断 是 父 类 还 是 具体 子 类 
一 译注 ) 时 执行 。 可 用 于 基于 内 容 的 鉴别 器 。 


鉴别 器 字段 的 实际 值 是 根据 &lt;class@gt; 和 &lt;subclass&gt， 元素 中 

的 discriminator-value 属性 得 来 的 。 

force 属性 仅仅 在 这 种 情况 下 有 用 的 : 表 中 包含 没有 被 映射 到 持久 化 类 的 附加 辨 
别 器 值 。 这 种 情况 不 会 经 常 遇 到 。 

使 用 formula 属性 你 可 以 定义 一 个 SQL 表达 式 ， 用 来 判断 一 个 行 数据 的 类 型 。 


<discriminator 
formula="case when CLASS TYPE in ('a', 'b', 'c') then 0 else 1 


type="integer"/> 








5.1.7. 版 本 (version) (可 选 ) 


&lt;version&agt; 元 素 是 可 选 的 ， 表 明 表 中 包含 附带 版 本 信息 的 数据 。 这 在 你 准 
各 使 用 长 事务 (long transactions) 的 时 候 特 别 有 用 。 ( 见 后 ) 


<version 
column="version_column" 
name="propertyName" 
type="typename" 
access="field|property|ClassName" 
unsaved -value="null1|negative|undefined" 
generated="never | always" 
insert="true|false" 
node="element -name|@attribute-name|element/@attribute|." 


/> 

@@ column (可 选 - 默认 为 属性 名 ): 指定 持 有 版 本 号 的 字段 名 。 

@ name :持久 化 类 的 属性 名 。 

© type (可 选 - 默认 是 integer ): 版 本 号 的 类 型 。 

@ access (可 选 - 默认 是 property ): Hibernate 用 于 访问 属性 值 的 策略 。 


unsaved-value (可 选 -默认 是 undefined ): 用 于 标明 某 个 实例 时 刚刚 被 
Ə 实例 化 的 (尚未 保存 ) 版 本 属性 值 ， 依 靠 这 个 值 就 可 以 把 这 种 情况 和 已 经 在 

先前 的 session 中 保存 或 装载 的 脱 管 (detached) 实例 区 分 开 来 。 

( undefined 指明 应 被 使 用 的 标识 属性 值 。) 


generated (可 选 - 默认 是 never ): 表明 此 版 本 属性 值 是 否 实际 上 是 由 数 
O 据 库 生成 的 。 请 参阅 第 5.6 节 “数据 库 生 成 属性 (Generated 
Properties)“ 部 分 的 讨论 。 


en (可 选 - 默认 是 true ) 表明 此 版 本 列 应 该 包含 在 SQL 插 入 语句 

中 。 只 有 当 数 据 库 字 段 有 默认 值 9 的 时 候 ， 才 可 以 设置 为 false 。 
版 本 号 必须 是 以 下 类 型 : long, integer, short ，timestamp 或 
者 calendar 。 


一 个 脱 管 (detached) 实例 的 version 或 timestamp 属 性 不 能 为 空 (nul) ， 因 为 

Hibernate 不 管 unsaved-value 被 指定 为 何 种 策略 ， 它 将 任何 属性 为 空 的 version 

或 timestamp 实例 看 作为 瞬时 (transient) 实例 。 避免 Hibernate 中 的 传递 重 附 
(transitive reattachment) 问题 的 一 个 简单 方法 是 定义 一 个 不 能 为 空 的 version 或 

timestamp 属 性 ， 特 别 是 在 人 们 使 用 程序 分 配 的 标识 符 (assigned identifiers) 或 
合 主键 时 非常 有 用 ! 


5.1.8. timestamp (可 选 ) 


可 选 的 &1t ;timestamp&gt; 元 素 指明 了 表 中 包含 时 间 稚 数据 。 这 用 来 作为 版 本 
的 蔡 代 。 时 间 惟 本 质 上 是 一 种 对 乐观 锁定 的 一 种 不 是 特别 安全 的 实现 。 当 然 ， 有 时 
候 应 用 程序 可 能 在 其 他 方面 使 用 时 间 惟 。 


<timestamp 

column="timestamp_column" 

name="propertyName" 

access="field|property|ClassName" 

unsaved -value="null1|undefined" 

source="vm|db" 

generated="never | always" 

node="element -name|@attribute-name|element/@attribute|." 
/> 


column (Jit - 默认 为 属性 名 ): 持 有 时 间 戳 的 字段 名 。 


name : 在 持久 化 类 中 的 JavaBeans 风 格 的 属性 名 ， 其 Java 类 型 是 Date 
或 者 Timestamp 的 。 


© access (可 选 - 默认 是 property ): Hibernate 用 于 访问 属性 值 的 策略 。 


unsaved-value (可 选 - 默认 是 null ): 用 于 标明 某 个 实例 时 刚刚 被 实例 
化 的 (尚未 保存 ) 版 本 属性 值 ， 依 靠 这 个 值 就 可 以 把 这 种 情况 和 已 经 在 先前 


© 的 session 中 保存 或 装载 的 脱 管 (detached) 实例 区 分 开 来 。 
( undefined 指明 使 用 标识 属性 值 进行 这 种 判断 。) 
source (可 选 - 默认 是 vm ): Hibernate 如 何 才能 获取 到 时 间 稚 的 值 呢 ? 
从 数据 库 ， 还 是 当前 JVM ? 从 数据 库 获 取 会 带 来 一 些 负 担 ， 因 为 Hibernate 必 
= 须 访问 数据 库 来 获得 “下 一 个 值 ， 但 是 在 集群 环境 中 会 更 安全 些 。 还 要 注 


意 ， 并 不 是 所 有 的 Dialect (AZ) 都 支持 获得 数据 库 的 当前 时 间 戳 的 ， 
De ree Oe Ee (例如 
Oracle 8) 。 


generated (可 选 -默认 是 never ) 指出 时 间 惟 值 是 否 实际 上 是 由 数据 库 
@ 生成 的 .请 参阅 第 5.6 节 “数据 库 生 成 属性 (Generated Properties) "Bit 


论 。 


注意 ， G&lt;timestamp&gt; 和 &lt;version type="timestamp"&gt; 是 等 价 
的 。 并 

H &lt;timestamp source="db"&gt; 和 &lt;version type="dbtimestamp"&gt 
i=! ON 

是 等 价 的 。 


5.1.9. property 
&lt;property&gt; 元 素 为 类 定义 了 一 个 持久 化 的 ,JavaBean 风 格 的 属性 。 


<property 
name="propertyName" 
column="column_name" 
type="typename" 
update="true|false" 
insert="true|false" 
formula="arbitrary SQL expression" 
access="field|property|ClassName" 
lazy="true|false" 
unique="true|false" 
not-null="true|false" 
optimistic-lock="true| false" 
generated="never |insert|always" 
node="element -name|@attribute-name|element/@attribute|." 


index="index_name" 
unique_key="unique_key_id" 
length="L" 
precision="P" 
scale="S" 

/> 


O name : 属性 的 名 字 , 以 小 写字 母 开头 。 

column (可 选 - 默认 为 属性 名 字 ): 对 应 的 数据 库 字 段 名 。 BALE 

的 &lt;column&gt; 元 素 指 定 。 

© type (TŻ): 一 个 Hibernate 类 型 的 名 字 。 
update, insert (可 选 - 默认 为 true ) : 表明 用 于 UPDATE 和 /或 
INSERT 的 SQL 语句 中 是 否 包含 这 个 被 映射 了 的 字段 。 这 二 者 如 果 都 设置 

@ 为 false 则 表明 这 是 一 个 “外 源 性 (derived) ”的 属性 ， 它 的 值 来 源 于 映射 
到 同一 个 (或 多 个 ) 字段 的 某 些 其 他 属性 ， 或 者 通过 一 个 trigger( 触 发 器 ) 
或 其 他 程序 生成 。 


formula (可 选 ): 一 个 SQL 表达 式 ， 定 义 了 这 个 计算 (computed) 属性 的 


© 值 。 计 算 属性 没有 和 它 对 应 的 数据 库 字 段 。 
@ access (可 选 - 默认 值 为 property ): Hibernate 用 来 访问 属性 值 的 策 
AE. 
q@ lazy (Aik - 默认 为 false ) 指定 指定 实例 变量 第 一 次 被 访问 时 ， 这 个 
属性 是 否 延 迟 抓 取 (fetched lazily) ( 需要 运行 时 字 节 码 增强 ) o 
@ unique (可 选 ) 使 用 DDL 为 该 字段 添加 唯一 的 约束 。 BH, RHC 


为 property-ref 引用 的 目标 。 
© not-null (可 选 ): 使 用 DDL 为 该 字段 添加 可 否 为 空 (nullability) 的 约束 。 


optimistic-lock (可 选 - 默认 为 true ) 指定 这 个 属性 在 做 更 新 时 是 否 
@ 需要 获得 乐观 锁定 (optimistic 换 句 话说 ， 它 决定 这 个 属性 发 生 脏 
数据 时 版 本 (version) 的 值 是 否 增 长 。 


generated (可 选 - 默认 为 never ): 表明 此 属性 值 是 否 实际 上 是 由 数据 库 
o 生成 的 。 请 参阅 第 5.6 节 “数据 库 生 成 属性 (Generated Properties) "Bit 


Oo 
typename PJ LA ÆA F JLF : 
1. Hibernate 基 本 类 型 名 (Lb 


如 : integer, string, character,date, timestamp, float, binary, s 


Ja 
2. 一 个 Java 类 的 名 字 ， 这 个 类 属于 一 种 默认 基础 类 型 (比如 : 


int, float, char, ace ee String, java.util.Date, java.lang.Int 


)。 
3. 一 个 可 以 序列 化 的 Java 类 的 名 字 。 


4. 一 个 自 定义 类 型 的 类 的 名 字 。 (上 比如: 
com.illflow.type.MyCustomType )。 


如 果 你 没有 指定 类 型 ，Hibernarte 会 使 用 反射 来 得 到 这 个 名 字 的 属性 ， 以 此 来 猜测 
正确 的 Hibernate 关 型 。 Hibernate 会 按照 规则 2,3,4 的 顺序 对 属性 读 取 器 (getter 方 
法 ) 的 返 类 进行 解释 。 然而 ， 这 还 不 够 。 在 某 些 情况 下 你 仍然 需要 type 属 
性 。 (比如 ， 为 了 区 别 Hibernate.DATE 和 Hibernate.TIMESTAMP ,或 者 为 了 指 
定 一 个 自 定义 类 型 。) 


access 属性 用 来 让 你 控制 Hibernate 如 何在 运行 时 访问 属性 。 在 默认 情况 下 ， 
Hibernate 会 使 用 属性 的 get/set 方 法 对 (pair) 。 如 果 你 指明 access="field" , 
ee ee 直接 使 用 反射 来 访问 成 员 变 量 。 你 也 可 以 指定 你 自 
己 的 策略 ， 这 就 需要 你 自己 实 

m org.hibernate.property.PropertyAccessor 接口 ， 再 在 access 中 设置 你 自 
定义 策略 类 的 名 字 。 


衍生 属性 (derive propertie) 是 一 个 特别 强大 的 特征 。 这 些 属 性 应 该 定义 为 只 读 ， 
属性 值 在 装载 时 计算 生成 。 你 用 一 个 SQL 表达 式 生 成 计算 的 结果 ， 它 会 在 这 个 实例 
转载 时 翻译 成 一 个 SQL 查询 的 SELECT 子 查询 语句 。 


<property name="totalPrice" 
formula="( SELECT SUM (li.quantity*p.price) FROM LineItem li, F 
WHERE 1i.productId = p.productId 
AND 1i.customerId = customerId 
AND 1i.orderNumber = orderNumber )"/> 


| RR 
注意 ， 你 可 以 使 用 实体 自己 的 表 ， 而 不 用 为 这 个 特别 的 列 定义 别名 ( 上 面 例子 中 


的 customerId ) 。 同 时 注意 ， 如 果 你 不 喜欢 使 用 属性 ， 你 可 以 使 用 嵌 套 
BY &lt;formula&gt; 映射 元 素 。 





5.1.10. 多 对 一 (many-to-one) 


通过 many-to-one 元 素 ,可 以 定义 一 种 常见 的 与 另 一 个 持久 化 类 的 关联 。 这 种 关 
系 模型 是 多 对 一 关联 (实际 上 是 一 个 对 象 引 用 一 译注 ) : 这 个 表 的 一 个 外 键 引用 目 
标 表 的 主键 字段 。 


<many-to-one 
name="propertyName" 
column="column_name" 
class="ClassName" 
cascade="cascade_style" 
fetch="join|select" 
update="true|false" 
insert="true|false" 
property-ref="propertyNameFromAssociatedClass" 
access="field|property|ClassName" 
unique="true|false" 
not-null="true|false" 
optimistic-lock="true| false" 
lazy="proxy|no-proxy|false" 
not -found="ignore|exception" 
entity-name="EntityName" 
formula="arbitrary SQL expression" 
node="element -name|@attribute-name|element/@attribute|." 


embed-xml="true|false" 
index="index_name" 
unique_key="unique_key_id" 
foreign-key="foreign_key_name" 


/> 


@ name : 属性 名 。 


column (F) 外 间 字 段 名 。 它 也 可 以 通过 艇 套 的 alt;column&gt; 元 
素 指 定 。 

© class (可 选 - 默认 是 通过 反射 得 到 属性 类 型 ): 关联 的 类 的 名 字 。 

© cascade (级 联 ) (可 选 ): 指明 哪些 操作 会 从 父 对 象 级 联 到 关联 的 对 象 。 
fetch (可 选 - 默认 为 select ): 在 外 连接 抓 取 (outer-join fetching) 和 
序列 选择 抓 取 (sequential select fetching) 两 者 中 选择 其 一 。 

update, insert (可 选 - 默认 为 true ) 指定 对 应 的 字段 是 否 包含 在 用 
于 UPDATE 和 /或 INSERT 的 SQL 语句 中 。 如 果 二 者 都 是 false MRE 
@ 一 个 纯粹 的 “外 源 性 (derived) "关联 ， 它 的 值 是 通过 映射 到 同一 个 (或 多 
个 ) 字段 的 某 些 其 他 属性 得 到 或 者 通过 trigger( 触 发 器 ) 、 或 其 他 程序 生 
property-ref : (可 选 ) 指定 关联 类 的 一 个 属性 ， 这 个 属性 将 会 和 本 外 键 相 
对 应 。 如 果 没 有 指定 ， 会 使 用 对 方 关 联 类 的 主键 。 


@ access (可 选 - 默认 是 property ): Hibernate 用 来 访问 属性 的 策略 。 


unique (P): 使 用 DDL 为 外 键 字段 生成 一 个 唯一 约束 。 此 外 ， 这 也 可 以 
用 作 property-ref 的 目标 属性 。 这 使 关联 同时 具有 一 对 一 的 效果 。 


© not-null (可 选 ): 使 用 DDL 为 外 键 字段 生成 一 个 非 空 约束 。 


optimistic-lock (可 选 - 默认 为 true ) 指定 这 个 属性 在 做 更 新 时 是 否 
@ 需要 获得 乐观 锁定 (optimistic lock) 。 换 句 话说 ， 它 决定 这 个 属性 发 生 脏 
数据 时 版 本 (version) 的 值 是 否 增长 。 


lazy (可 选 - 默认 为 proxy ): 默认 情况 下 ， 单 点 关联 是 经 过 代理 
BY. lazy="no-proxy" 指定 此 属性 应 该 在 实例 变量 第 一 次 被 访问 时 应 该 延 


RAMEN (fetche lazily) (需要 运行 时 字 节 码 的 增强 ) 。 lazy="false" 指 
定 此 关联 总 是 被 预先 抓 取 。 
@ not-found (B -BAA exception ): 指定 外 键 引用 的 数据 不 存在 时 


如 何 义理 : ignore 会 将 行 数据 不 存在 视 为 一 个 空 (null) KK. 
© entity-name (可 选 ): 被 关联 的 类 的 实体 名 。 
© formula (可 选 ); SQL 表 达 式 ， 用 于 定义 computed (计算 出 的 ) 外 键 值 。 


cascade 属性 设置 为 除了 none 以 外 任何 有 意义 的 值 ， 它 将 把 特定 的 操作 传递 到 
关联 对 象 中 。 这 个 值 就 代表 着 Hibernate 基 本 操作 的 名 称 ， 

persist, merge, delete, save-update, evict, replicate, lock, refresl 
, 以 及 特别 的 值 delete-orphan 和 all ， 并 且 可 以 用 过 号 分 隔 符 来 组 合 这 些 操 
作 ， 例 如 ， cascade="persist,merge,evict" 或 
cascade="all,delete-orphan" 。 更 全 面 的 解释 请 参考 第 10.11 节 “ 传 播 性 持久 
{i (transitive persistence)”. 注意 ， 单 值 关联 (many-to-one 和 one-to-one 关联 ) 不 
支持 删除 孤儿 (orphan delete， 删 除 不 再 被 引用 的 值 ) . 


一 个 典型 的 简单 many-to-one 定义 例子 : 


<many-to-one name="product" class="Product" column="PRODUCT_ID"/> 


下 a a 








property-ref 属性 只 应 该 用 来 对 付 遗 留 下 来 的 数据 库 系统 ， 可 能 有 外 键 指向 对 
方 关联 表 的 是 个 非 主键 字段 〈 但 是 应 该 是 一 个 惟一 关键 字 ) 的 情况 下 。 这 是 一 种 十 
分 丑陋 的 关系 模型 。 比 如 说 ， 假 设 Product 类 有 一 个 惟一 的 序列 号 ， 它 并 不 是 主 
键 。 ( unique 属性 控制 Hibernate 通 过 SchemaExport 工 具 进 行 的 DDL 生 成 。 ) 


<property name="serialNumber" unique="true" type="string" column=": 
1 
那么 关于 orderItem 的 映射 可 能 是 : 





<many-to-one name="product" property-ref="SerialNumber" column="PR( 
JE 
当然 ， 我 们 决 不 鼓励 这 种 用 法 。 


如 果 被 引用 的 唯一 主键 由 关联 实体 的 多 个 属性 组 成 ， 你 应 该 在 名 称 
为 &1lt;properties&gt; 的 元 素 里 面 映 射 所 有 关联 的 属性 。 


假若 被 引用 的 唯一 主键 是 组 件 的 属性 ， 你 可 以 指定 属性 路 径 : 





<many-to-one name="owner" property-ref="identity.ssn" column="OWNEI 


回 





51 = 
持久 化 对 象 之 间 一 对 一 的 关联 关系 是 通过 one-to-one 元 素 定 义 的 。 


<one-to-one 
name="propertyName" 
class="ClassName" 
cascade="cascade_style" 
constrained="true|false" 
fetch="join|select" 
property-ref="propertyNameFromAssociatedClass" 
access="field|property|ClassName" 
formula="any SQL expression" 
lazy="proxy|no-proxy|false" 
entity-name="EntityName" 
node="element -name|@attribute-name|element/@attribute|." 


embed-xml="true|false" 
foreign-key="foreign_key_name" 
/> 


© name : 属性 的 名 字 。 


@ class (可 选 - 默认 是 通过 反射 得 到 的 属性 类 型 ) : 被 关联 的 类 的 名 字 。 

© cascade( 级 联 ) (可 选 ) 表明 操作 是 否 从 父 对 象 级 联 到 被 关联 的 对 象 。 
constrained( 约 束 ) (Ait) 表明 该 类 对 应 的 表 对 应 的 数据 库 表 ， 和 被 关联 

e 的 对 象 所 对 应 的 数据 库 表 之 间 ， 通 过 一 个 外 键 引用 对 主键 进行 约束 。 这 个 选 
项 影响 save() 和 delete() 在 级 联 执行 时 的 先后 顺序 以 及 决定 该 关联 能 
否 被 委托 (也 在 schema export tool 中 被 使 用 ). 

= fetch (可 选 - 默认 设置 为 选择 ) 在 外 连接 抓 取 或 者 序列 选择 抓 取 选择 其 

@ Property-ref : (可 选 ) 指定 关联 类 的 属性 名 ， 这 个 属性 将 会 和 本 类 的 主键 


相对 上 应。 如果 没有 指定 ， 会 使 用 对 方 关联 类 的 主键 。 
@ access (可 选 - 默认 是 property ): Hibernate 用 来 访问 属性 的 策略 。 


formula (可 选 ): 绝 大 多 数 一 对 一 的 关联 都 指向 其 实体 的 主键 。 在 一 些 少见 
的 情况 中 ， 你 可 能 会 指向 其 他 的 一 个 或 多 个 字段 ， 或 者 是 一 个 表达 式 ， 这 些 
情况 下 ， 你 可 以 用 一 个 SQL 公式 来 表示 。 (ALE 
org.hibernate.test.onetooneformula 找 到 例子 ) 


lazy (可 选 - 默认 为 proxy ): 默认 情况 下 ， 单 点 关联 是 经 过 代理 

的 。 lazy="no-proxy" 指定 此 属性 应 该 在 实例 变量 第 一 次 被 访问 时 应 该 延 
© RH (fetche lazily) (需要 运行 时 字 节 码 的 增强 ) 。 lazy="false" 指 

定 此 关联 总 是 被 预先 抓 取 。 注 意 ， 如 果 constrained="false" ,不 可 能 使 

用 代理 ，Hibernate 会 采取 预先 抓 取 ! 


@ entity-name (可 选 ) 被 关联 的 类 的 实体 名 。 
有 两 种 不 同 的 一 对 一 关联 : 

。 主键 关联 

o 惟一 外 键 关 联 
主键 关联 不 需要 额外 的 表 字 段 ; 如 果 两 行 是 通过 这 种 一 对 一 关系 相关 联 的 ， 那 么 这 
两 行 就 共享 同样 的 主 关键 字 值 。 所 以 如 果 你 希望 两 个 对 象 通 过 主键 一 对 一 关联 ， 你 
必须 确认 它们 被 赋予 同样 的 标识 值 ! 
比如 说 ， 对 下 面 的 Employee 和 Person 进行 主键 一 对 一 关联 : 


<one-to-one name="person" class="Person"/> 


<one-to-one name="employee" class="Employee" constrained="true"/> 


4 ee el 











现在 我 们 必须 确保 PERSON 和 EMPLOYEE 中 相关 的 字段 是 相等 的 。 我 们 使 用 一 个 
被 成 为 foreign 的 特殊 的 hibernate 标 识 符 生成 策略 : 


<class name="person" table="PERSON"> 
<id name="id" column="PERSON_ID"> 
<generator class="foreign"> 
<param name="property">employee</param> 
</generator> 
</id> 


<one-to-one name="employee" 
class="Employee" 
constrained="true"/> 
</class> 


一 个 刚刚 保存 的 Person 实例 被 赋予 和 该 Person 的 employee 属性 所 指向 
的 Employee 实例 同样 的 关键 字 值 。 


另 一 种 方式 是 一 个 外 键 和 一 个 惟一 关键 字 对 应 ， 上 面 的 Employee 和 Person 的 
例子 ， 如 果 使 用 这 种 关联 方式 ， 可 以 表达 成 : 


<many-to-one name="person" class="Person" column="PERSON_ID" unique 


‘| — R 





如 果 在 Person 的 映射 加 入 下 面 几 句 ， 这 种 关联 就 是 双向 的 : 


<one-to-one name"employee" class="Employee" property-ref="person"/: 


a "| 


5.1.12. 自然 ID(natural-id) 


<natural-id mutable="true|false"/> 
<property ... /> 
<many-to-one ... /> 


</natural-id> 


我 们 建议 使 用 代用 键 ( 键 值 不 具备 实际 意义 ) 作为 主键 ， 我 们 仍然 应 该 党 试 为 所 有 
的 实体 采用 自然 的 键 值 作为 (附加 译 者 注 ) 标示 。 自 然 键 (natural key) 是 单 
个 或 组 合 属性 ， 他 们 必须 唯一 且 非 空 。 如 果 它 还 是 不 可 变 的 那 就 更 理想 了 。 

在 &lt;natural-id&gt; 元 素 中 列 出 自然 键 的 属性 。Hibernate 会 帮 你 生成 必须 的 
唯一 键 值 和 非 空 约束 ， 你 的 映射 会 更 加 的 明显 易 懂 (原文 是 self-documenting， 自 
我 注解 ) 。 

我 们 强烈 建议 你 实现 equals() 和 hashCode() 方法 ,来 比较 实体 的 自然 键 属性 。 
这 一 映射 不 是 为 了 把 自然 键 作为 主键 而 准 各 的 。 


。 mutable (可 选 , 默认 为 false ): 默认 情况 下 ， 自 然 标 识 属性 被 假定 为 不 可 
EA (RB) 。 





5.1.13. 组 件 (component), 动态 组 件 (dynamic- 


component) 


&lt;component&gt， 元 素 把 子 对 象 的 一 些 元 素 与 父 类 对 应 的 表 的 一 些 字段 映射 起 


来 。 然后 组 件 可 以 定义 它们 自己 的 属性 、 组 件 或 者 集合 。 参 见 


的 “Components” 一 章 。 


<component 
name="propertyName" 
class="className" 
insert="true|false" 
update="true|false" 
access="field|property|ClassName" 
lazy="true|false" 
optimistic-lock="true| false" 
unique="true|false" 
node="element-name|." 


<property ..-.. /> 
<many-to-one .... /> 


</component> 


name : 属性 名 


© © © © © 


后 面 


class (可 选 - 默认 为 通过 反射 得 到 的 属性 类 型 ): 组 件 ( 子 ) 类 的 名 字 。 
insert : 被 映射 的 字段 是 否 出 现在 SQL 的 INSERT 语句 中 ? 

update : 被 映射 的 字段 是 否 出 现在 SQL 的 UPDATE 语句 中 ? 

access (可 选 -默认 是 property ): Hibernate 用 来 访问 属性 的 策略 。 


lazy (可 选 - 默认 是 false ): 表明 此 组 件 应 在 实例 变量 第 一 次 被 访问 的 


© ”时候 延 这 加 载 (需要 编译 时 字 节 芭 装 置 器 ) 


optimistic-lock (可 选 - 默认 是 true ): 表 明 更 新 此 组 件 是 否 需要 获取 
乐观 锁 。 换 名 话说 ， 当 这 个 属性 变 脏 时 ， 是 否 增加 版 本 号 (Version) 


© 


约束 


unique (可 选 - 默认 是 false ): 表 明 组 件 映射 的 所 有 字段 上 都 有 唯一 性 


其 &1t;property&gt; 子 标签 为 子 类 的 一 些 属性 与 表 字 段 之 间 建 立 映 射 。 


&lt;component&gt; 元 素 允 许 加 入 一 个 &lt;parent&gt; 
部 就 可 以 有 一 个 指向 其 容器 的 实体 的 反 向 引用 。 


子 元 素 ， 在 组 件 类 内 


&lt;dynamic-componentégt; 元 素 允 许 把 一 个 Map 映射 为 组 件 ， 其 属性 名 对 应 
map 的 键 值 。 参见 第 8.5 节 “动态 组 件 (Dynamic components) ”. 


5.1.14. properties 


&lt;properties&gt; ”元素 人 允许 定义 一 个 命名 的 逻辑 分 组 (grouping) 包 含 一 个 类 
中 的 多 个 属性 。 这 个 元 素 最 重要 的 用 处 是 允许 多 个 属性 的 组 合作 
为 property-ref 的 目标 (target)。 这 也 是 定义 多 字段 唯一 约束 的 一 种 方便 途径 。 


<properties 
name="logicalName" 
insert="true|false" 
update="true|false" 
optimistic-lock="true|false" 
unique="true|false" 


> 
<property ..... /> 
<many-to-one .... /> 
</properties> 


@ name :分 组 的 逻辑 名 称 -不 是 实际 属性 的 名 称 . 
© insert : 被 映射 的 字段 是 否 出 现在 SQL 的 INSERT 语句 中 ? 
© update : 被 映射 的 字段 是 否 出 现在 SQL 的 ”UPDATE 语句 中 ? 


optimistic-lock nee 默认 是 true ): 表 明和 更 新 此 组 件 是 否 需要 获取 
乐观 锁 。 换 名 话说 ， 当 这 个 属性 变 脏 时 ， 是 否 增加 版 本 号 (Version) 


unique (可 选 - 默认 是 false ): 表 明 组 件 映射 的 所 有 字段 上 都 有 唯一 性 
约束 


例如 ， 如 果 我 们 有 如 下 的 alt;properties&gt; PRAT: 


© 


<class name="Person"> 
<id name="personNumber"/> 


<properties name="name" 
unique="true" update="false"> 
<property name="firstName"/> 
<property name="initial"/> 
<property name="lastName"/> 
</properties> 
</class> 


然后 ， 我 们 可 能 有 一 些 遗 留 的 数据 关联 ， 引 用 Person 表 的 这 个 唯一 键 ， 而 不 是 
主键 。 


<many-to-one name="person" 
class="Person" property-ref="name"> 
<column name="firstName"/> 
<column name="initial"/> 
<column name="lastName"/> 
</many - to-one> 


我 们 并 不 推荐 这 样 使 用 ， 除 非 在 映射 遗留 数据 的 情况 下 。 


5.1.15. F ž (subclass) 


最 后 ， 多 态 持 久 化 需要 为 父 类 的 每 个 子 类 都 进行 定义 。 对 于 “每 一 棵 类 继承 树 对 应 一 
个 表 " 的 策略 来 说 ， 就 需要 使 用 &lt;subclass&gt; 定义 。 


<subclass 
name="ClassName" 
discriminator -value="discriminator_value" 
proxy="ProxyInterface" 
lazy="true|false" 
dynamic -update="true|false" 
dynamic -insert="true|false" 
entity-name="EntityName" 
node="element -name" 
extends="SuperclassName"> 


<property .... /> 


</subclass> 


。 name : 子 类 的 全 限定 名 。 


discriminator-value( 辨 别 标志 ) (可 选 - 默认 为 类 名 ): 一 个 用 于 区 分 每 个 
独立 的 子 类 的 值 。 
o proxy (代理) (可 选 ): 指定 一 个 类 或 者 接口 ， 在 延迟 装载 时 作为 代理 使 用 。 
。 lazy (可 选 , 默认 是 true ): 设置 为 lazy="false" 茶 止 使 用 延迟 抓 取 
每 个 子 类 都 应 该 定义 它 自己 的 持久 化 属性 和 子 类 。 &lt;versionggt; 
和 &lt;id&gt; 属性 可 以 从 根 父 类 继承 下 来 。 在 一 棵 继承 树 上 的 每 个 子 类 都 必须 
定义 一 个 唯一 的 discriminator-value 。 如 果 没 有 指定 ， 就 会 使 用 Java 类 的 全 限 
定名 。 


更 多 关于 继承 映射 的 信息 , 参考 第 9 章 继承 映射 (Inheritance Mappings) 章 节 . 


5.1.16. 连接 的 子 类 (joined-subclass) 


.1 
此 外 ， 每 个 子 类 可 能 被 映射 到 他 自己 的 表 中 (每 个 子 类 一 个 表 的 策略 )。 被 继承 的 状 
态 通过 和 超 类 的 表 关 联 得 到 。 我 们 使 用 &lt;joined-subclass&gt; 元 素 。 


wa 


<joined-subclass 
name="ClassName" 
table="tablename" 
proxy="ProxyInter face" 
lazy="true|false" 
dynamic -update="true|false" 
dynamic -insert="true|false" 
schema="schema" 
catalog="catalog" 
extends="SuperclassName" 
persister="ClassName" 
subselect="SQL expression" 
entity-name="EntityName" 
node="element -name"> 


<key .... > 


<property .... /> 


</joined-subclass> 


9 name : 子 类 的 全 限定 名 。 

© table : 子 类 的 表 名 . 

© proxy (Ait) 指定 一 个 类 或 者 接口 ， 在 延迟 装载 时 作为 代理 使 用 。 
lazy (可 选 , 默认 是 true ): 设置 为 lazy="false" 禁止 使 用 延迟 装 
载 。 


这 种 映射 策略 不 需要 指定 辨别 标志 (discriminaton) 字 段 。 但 是 ， 每 一 个 子 类 都 必须 使 
FA alt;key&gt; 元 素 指 定 一 个 表 字 段 来 持 有 对 象 的 标识 符 。 本 章 开 始 的 映射 可 以 
被 用 如 下 方式 重 写 : 


(4 


<?xml version="1.0"?> 

<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD//EN" 
"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dt¢ 


<hibernate-mapping package="eg"> 


<class name="Cat" table="CATS"> 
<id name="id" column="uid" type="long"> 
<generator class="hilo"/> 
</id> 
<property name="birthdate" type="date"/> 
<property name="color" not-null="true"/> 
<property name="sex" not-null="true"/> 
<property name="weight"/> 
<many-to-one name="mate"/> 
<set name="kittens"> 
<key column="MOTHER"/> 
<one-to-many class="Cat"/> 
</set> 
<joined-subclass name="DomesticCat" table="DOMESTI( 
<key column="CAT"/> 
<property name="name" type="string"/> 
</joined-subclass> 
</class> 


<class name="eg.Dog"> 
<!-- mapping for Dog could go here --> 
</class> 
</hibernate-mapping> 


Ki = ; 
更 多 关于 继承 映射 的 信息 ， 参 考 第 9 章 继承 映射 (Inheritance Mappings). 





5.1.17. 联合 


第 三 种 选择 是 仅仅 映射 类 继承 树 中 具体 类 
其 中 ， 每 张 表 定义 了 类 的 所 有 持久 化 状态 ， 包 括 继承 的 状态 。 
不 需要 完全 显 式 地 映射 这 样 的 继承 树 。 你 可 以 简单 地 使 用 单独 
的 &lt;classagt; 定义 映射 每 个 类 。 然 而 ， 如 果 你 想 使 用 多 态 关 联 (例如 ， 


类 继承 树 中 超 类 的 关联 )， 你 需要 使 用 &lt;union-subclass&gt; 映射 。 


<union-subclass 


name="ClassName" 
table="tablename" 
proxy="ProxyInter face" 
lazy="true|false" 

dynamic -update="true|false" 
dynamic -insert="true|false" 
schema="schema" 
catalog="catalog" 
extends="SuperclassName" 
abstract="true|false" 
persister="ClassName" 
subselect="SQL expression" 
entity-name="EntityName" 
node="element -name"> 


<property .... /> 


</union-subclass> 


14] 


这 种 映射 策略 不 需要 指定 辨别 
更 多 关于 继承 映射 的 信息 ， 


name : 子 类 的 全 限定 名 。 
table : 子 类 的 表 名 


proxy (Alt): 指定 一 个 类 或 者 接口 ， 在 延迟 装载 时 作为 代理 使 用 。 


类 (union-subclass) 


部 分 到 表 中 (每 个 具体 类 一 张 表 的 策略 )。 


在 Hibernate 中 ， 并 


一 个 对 


lazy (可 选 , 默认 是 true ): 设置 为 lazy="false" 禁止 使 用 延迟 装 


载 。 


标志 (discriminator) 字 段 。 


参考 第 9 章 继承 映射 (Inheritance Mappings). 


5.1.18. 连接 (join) 


使 用 &lt;join&gt; 元素， 假若 在 表 之 间 存 在 一 对 一 关联 ,可 以 将 一 个 类 的 属性 映 
射 到 多 张 表 中 。 
<join 
table="tablename" 
schema="owner" 
catalog="catalog" 
fetch="join|select" 


inverse="true|false" 
optional="true|false"> 


<key ... /> 
<property ... /> 


</join> 


table : 被 连接 表 的 名 称 。 
schema (可 选 ): 履 盖 由 根 &lt;hibernate-mapping&gt; 元 素 指定 的 模式 


© 名 称 。 

@ catalog (可 选 ): BEAR &1lt;hibernate-mapping&gt; 元 素 指定 的 目 
录 名 称 。 
fetch (可 选 - 默认 是 join ): 如 果 设 置 为 默认 值 join , Hibernate 将 
使 用 一 个 内 连接 来 得 到 这 个 类 或 其 超 类 定义 的 &1t;join&gt; ， 而 使 用 一 

© 个 外 连接 来 得 到 其 子 类 定义 的 &1t;join&gt; 。 如 果 设 置 为 select ， 则 
Hibernate 将 为 子 类 定义 的 &1t;join&gt; 使 用 顺序 选择 。 这 仅 在 一 行 数 
据 表 示 一 个 子 类 的 对 象 的 时 候 才 会 发 生 。 对 这 个 类 和 其 超 类 定义 
的 &lt;join&gt; ， 依 然 会 使 用 内 连接 得 到 。 

@ inverse (可 选 - 默认 是 false ): 如 果 打 开 ，Hibernate 不 会 插入 或 者 更 
新 此 连接 定义 的 属性 。 

@ optional (可 选 - 默认 是 false ): 如 果 打 开 ，Hibernate 只 会 在 此 连接 定 


义 的 属性 非 空 时 插 和 人 一行 数 据 ， 并 且 总 是 使 用 一 个 外 连接 来 得 到 这 些 属性 。 


例如 ， 一 个 人 (person) 的 地 址 (address) 信 息 可 以 被 映射 到 单独 的 表 中 (并 保留 所 有 属 
性 的 值 类 型 语义 ) : 


<class name="Person" 
table="PERSON"> 


<id name="id" column="PERSON_ID">...</id> 


<join table="ADDRESS"> 
<key column="ADDRESS_ID"/> 
<property name="address"/> 
<property name="zip"/> 
<property name="country"/> 
</join> 


此 特性 常常 对 遗留 数据 模型 有 有用， 我 们 推荐 表 个 数 比 类 个 数 少 ， 以 及 细 粒 度 的 领域 
模型 。 然 而 ， 在 单独 的 继承 树 上 切换 继承 映射 策略 是 有 用 的 ， 后 面 会 解释 这 点 。 


5.1.19. 键 (key) 


我 们 目前 已 经 见 到 过 alt;key&gt; 元 素 多 次 了 。 这 个 元 素 在 父 映 射 元 素 定 义 了 对 
新 表 的 连接 ， 并 且 在 被 连接 表 中 定义 了 一 个 外 键 引用 原 表 的 主键 的 情况 下 经 常 使 
用 


<key 
column="columnname" 
on-delete="noaction|cascade" 
property-ref="propertyName" 
not-null="true|false" 
update="true| false" 
unique="true|false" 

/> 


column (Fit): 外 键 字 段 的 名 称 。 也 可 以 通过 散 套 的 
&lt:column&gt; 指定 。 


on-delete (可 选 , 默认 是 noaction ): 表明 外 键 关联 是 否 打 开 数 据 库 级 
别 的 级 联 删 除 。 


property-ref (可 选 ): 表明 外 键 引用 的 字段 不 是 原 表 的 主键 (提供 给 遗留 
数据 )。 


not-null (可 选 ): 表明 外 键 的 字段 不 可 为 空 (这 意味 着 无 论 何 时 外 键 都 是 
主键 的 一 部 分 )。 


update (可 选 ): 表明 外 键 决 不 应 该 被 更 新 (这 意味 着 无 论 何 时 外 键 都 是 主 
键 的 一 部 分 )。 


unique (可 选 ): 表明 外 键 应 有 唯一 性 约束 (这 意味 着 无 论 何 时 外 键 都 是 主 
键 的 一 部 分 )。 


对 那些 看 重 删 除 性 能 的 系统 ， 我 们 推荐 所 有 的 键 都 应 该 定义 

为 on-delete="cascade" ， 这 样 Hibernate 将 使 用 数据 库 级 

的 ON CASCADE DELETE 约束 ， 而 不 是 多 个 DELETE 语句 。 注意 ， 这 个 特性 会 绕 
过 Hibernate 通常 对 版 本 数据 (versioned data) 采 用 的 乐观 锁 策 略 。 


not-null 和 update 属性 在 映射 单 向 一 对 多 关联 的 时 候 有 用 。 如 果 你 映射 一 
个 单 向 一 对 多 关联 到 非 空 的 (non-nullable) 外 键 ， 你 必须 
FA &lt;key not-null="true"&gt; 定义 此 键 字段 。 


5.1.20. 字段 和 规则 元 素 (column and formula 


elements) 


任何 接受 column 属性 的 映射 元 素 都 可 以 选择 接受 &lt;column&gt; 


样 的 ， formula 子 元 素 也 可 以 替换 &lt;formulaggt; 属性 。 


<column 
name="column_name" 
length="N" 
precision="N" 
scale="N" 


not-null="true|false" 
unique="true|false" 
unique-key="multicolumn_unique_key_name" 
index="index_name" 
sql-type="sql_type_name" 

check="SQL expression" 

default="SQL expression"/> 


<formula>SQL expression</formula> 


子 元 素 。 同 


column 和 formula 属性 甚至 可 以 在 同一 个 属性 或 关联 映射 中 被 合并 来 表达 ， 


例如 ， 一 些 奇 异 的 连接 条 件 。 


<many-to-one name="homeAddress" class="Address" 
insert="false" update="false"> 


<column name="person_id" not-null="true" length="10"/> 


<formula>'MAILING'</formula> 
</many - to-one> 


5.1.21. 引用 (import) 


假设 你 的 点 用 程序 有 两 个 同样 名 字 的 持久 化 类 ， 但 是 你 不 想 在 Hibernate 查 询 中 使 用 
他 们 的 全 限定 名 。 除 了 依赖 auto-import="true" 以 外 ， 类 也 可 以 被 显 式 
地 “import( 引 用 >。 你 其 至 可 以 引用 没有 被 明确 映射 的 类 和 接口 。 


<import class="java.lang.Object" rename="Universe"/> 


<import 
class="ClassName" 
rename="ShortName" 


/> 


0 class : 任何 Java 类 的 全 限定 名 。 
@ rename (可 选 - 默认 为 类 的 全 限定 名 ): 在 查询 语句 中 可 以 使 用 的 名 字 。 


5.1.22. any 


这 是 属性 映射 的 又 一 种 类 型 。 &lt;any&gt; 了 映射 元 素 定 义 了 一 种 从 多 个 表 到 类 的 
多 态 关联 。 这 种 类 型 的 映射 常常 需要 多 于 一 个 字段 。 第 一 个 字段 持 有 被 关联 实体 的 
类 型 ， 其 他 的 字段 持 有 标识 符 。 对 这 种 类 型 的 关联 来 说 ， 不 可 能 指定 一 个 外 键 约 
束 ， 所 以 这 当然 不 是 映射 (多 态 ) 关 联 的 通常 的 方式 。 你 只 应 该 在 非常 特殊 的 情况 下 
使 用 它 (比如 ， 审 计 log， 用 户 会 话 数据 等 等 )。 


meta-type 属性 使 得 点 用 程序 能 指定 一 个 将 数据 库 字段 的 值 映 射 到 持久 化 类 的 自 
定义 类 型 。 这 个 持久 化 类 包含 有 用 id-type 指定 的 标识 符 属 性 。 你 必须 指定 从 
meta-type 的 值 到 类 名 的 映射 。 


<any name="being" id-type="long" meta-type="string"> 
<meta-value value="TBL_ANIMAL" class="Animal"/> 
<meta-value value="TBL_HUMAN" class="Human"/> 
<meta-value value="TBL_ALIEN" class="Alien"/> 
<column name="table_name"/> 
<column name="id"/> 

</any> 


<any 
name="propertyName" 
id-type="idtypename" 
meta-type="metatypename" 
cascade="cascade_style" 
access="field|property|ClassName" 
optimistic-lock="true| false" 


<meta-value ... /> 
<meta-value ... /> 
<column .... /> 
<column .... /> 


name : 属性 名 
id-type : 标识 符 类 型 


meta-type (可 选 -默认 是 string ): 人 允许 辨别 标志 (discriminator) 映 射 的 
任何 类 型 


cascade (可 选 -默认 是 none ): 级 联 的 类 型 
access (可 选 -默认 是 property ): Hibernate 用 来 访问 属性 值 的 策略 。 


optimistic-lock (可 选 -默认 是 true ): 表明 更 新 此 组 件 是 否 需要 获取 
乐观 锁 。 换 名 话说 ， 当 这 个 属性 变 脏 时 ， 是 否 增加 版 本 号 (Version) 


5.2. Hibernate 的 类 型 


5.2.1. 实体 (Entities) 和 值 (values) 


为 了 理解 很 多 与 持久 化 服务 相关 的 Java 语 言 级 对 象 的 行为 ， 我 们 需要 把 它们 分 为 两 


HR . 


实体 entity 独立 于 任何 持 有 实体 引用 的 对 象 。 与 通常 的 Java 模 型 相 比 ， 不 再 被 引用 

的 对 象 会 被 当 作 垃 圾 收集 掉 。 实 体 必须 被 显 式 的 保存 和 出 除 (除非 保存 和 删除 是 从 父 
实体 向 子 实体 引发 的 级 联 )。 这 和 ODMG 模 型 中 关于 对 象 通过 可 触及 保持 持久 性 有 

一 些 不 同一 一 比较 起 来 更 加 接近 应 用 程序 对 象 通常 在 一 个 大 系统 中 的 使 用 方法 。 实 
体 支 持 循环 引用 和 交叉 引用 ， 它 们 也 可 以 加 上 版 本 信息 。 


一 个 实体 的 持久 状态 包含 指向 其 他 实体 和 值 类 型 实例 的 引用 。 值 可 以 是 原始 类 型 ， 
集合 (不 是 集合 中 的 对 象 )， 组 件 或 者 特定 的 不 可 变 对 象 。 和 与 实体 不 同 ， 值 (特别 是 集 
合 和 组 件 ) 是 通过 可 触及 性 来 进行 持久 化 和 删除 的 。 因 为 值 对 象 (和 原始 类 型 数据 ) 是 
随 着 包含 他 们 的 实体 而 被 持久 化 和 删除 的 ， 他 们 不 能 被 独立 的 加 上 版 本 信息 。 值 没 
有 独立 的 标识 ， 所 以 他 们 不 能 被 两 个 实体 或 者 集合 共享 。 


直到 现在 ， 我 们 都 一 直 使 用 术语 “持久 类 "(persistent class) 来 代表 实体 。 我 们 仍然 会 
这 么 做 。 然而 严格 说 来 ， 不 是 所 有 的 用 户 自 定义 的 ， 带 有 持久 化 状态 的 类 都 是 实 

体 。 组 件 就 是 用 户 自 定义 类 ， 却 是 值 语义 的 。 java.lang.String 类 型 的 java 属 

性 也 是 值 语义 的 。 给 了 这 个 定义 以 后 ， 我 们 可 以 说 所 有 JDK 提 供 的 类 型 (类 ) 都 是 值 

类 型 的 语义 ， 而 用 于 自 定义 类 型 可 能 被 映射 为 实体 类 型 或 值 类 型 语义 。 采 用 哪 种 类 
型 的 语义 取决 于 开发 人 员 。 在 领域 模型 中 ， 寻 找 实 体 类 的 一 个 好 线索 是 共享 引用 指 
向 这 个 类 的 单一 实例 ， 而 组 合 或 聚合 通常 被 转化 为 值 类 型 。 


我 们 会 在 本 文档 中 重复 碰 到 这 两 个 概念 。 


挑战 在 于 将 java 类 型 系统 (和 开发 者 定义 的 实体 和 值 类 型 ) 映 射 到 SQL/ 数 据 库 类 型 系 
统 。Hibernate 提 供 了 连接 两 个 系统 之 间 的 桥梁 : 对 于 实体 类 型 ， 我 们 使 

用 &lt;class&gt; , &lt;subclass&gt; 等 等 。 对 于 值 类 型 ， 我 们 使 用 
&lt;property&gt; , &lt;component&gt; 及 其 他 ， 通 常 跟随 着 type BIE. 
这 个 属性 的 值 是 Hibernate 的 映射 类 型 的 名 字 。Hibernate 提 供 了 许多 现成 的 映射 ( 标 
准 的 JDK 值 类 型 )。 你 也 可 以 编写 自己 的 映射 类 型 并 实现 自 定义 的 变换 策略 ， 随 后 我 
们 会 看 到 这 点 。 


所 有 的 Hibernate 内 建 类 型 ， 除 了 collections 以 外 ， 都 支持 空 (null) 语 义 。 





5.2.2. 基本 值 类 型 


内 建 的 基本 映射 类 型 可 以 大 致 分 为 


integer, long, short, float, double, character, byte, boolean, yes_! 


这 些 类 型 都 对 应 Java 的 原始 类 型 或 者 其 封装 类 ， 来 符合 (特定 厂商 的 )SQL 字段 类 
AJ, boolean, yes_no 和 true_false 都 是 Java 中 boolean 或 
者 java.lang.Boolean 的 另外 说 法 。 


string 
从 java.lang.String 到 VARCHAR (或 者 Oracle 的 VARCHAR2 ) 的 映射 。 
date, time, timestamp 


从 java.util.Date 和 其 子 类 到 SQL 类 型 DATE ，TIME 和 TIMESTAMP (或 等 价 
类 型 ) 的 映射 。 


calendar, calendar_date 


从 java.util.Calendar 到 SQL 类 型 TIMESTAMP 和 DATE (或 等 价 类 型 ) 的 映 
射 。 


big decimal, big_integer 


从 java.math.BigDecimal 和 java.math.BigInteger 到 NUMERIC (或 者 
Oracle 的 NUMBER 类 型 ) 的 映射 。 


locale, timezone, currency 


从 java.util.Locale , java.util.TimeZone 和 java.util.Currency 
到 VARCHAR (或 者 Oracle BY VARCHAR2 类 型 ) 的 映射 .Locale 和 Currency 的 
实例 被 映射 为 它们 的 ISO 代码 。 TimeZone 的 实例 被 影射 为 它 的 ID. 


class 


从 java.lang.Class 到 VARCHAR (或 者 Oracle 的 VARCHAR2 类 型 ) 的 映 
At, Class 被 映射 为 它 的 全 限定 名 。 


binary 

把 字 节 数组 (byte arrays) 映 射 为 对 应 的 SQL 二 进 制 类 型 。 
text 

把 长 Java 字 符 串 映射 为 SQL 的 CLOB 或 者 TEXT 类 型 。 
serializable 


把 可 序列 化 的 Java 类 型 映射 到 对 应 的 SQL 二 进 制 类 型 。 你 也 可 以 为 一 个 并 非 默认 为 
基本 类 型 的 可 序列 化 Java 类 或 者 接口 指定 Hibernate 类 型 serializable 。 


clob, blob 


JDBC 类 java.sql.Clob 和 java.sql.Blob 的 映射 。 某 些 程序 可 能 不 适合 使 
用 这 个 类 型 ， 因 为 blob 和 clob 对 象 可 能 在 一 个 事务 之 外 是 无 法 重用 的 。( 而 且 , 驱动 
程序 对 这 种 类 型 的 支持 充满 着 补丁 和 前 后 矛盾 。 ) 


imm_date, imm_time, imm_timestamp, imm_calendar, imm_calendar_date, 


一 般 来 说 ， 映 射 类 型 被 假定 为 是 可 变 的 Java 类 型 ， 只 有 对 不 可 变 Java 类 型 ， 
Hibernate 会 采取 特定 的 优化 措施 ， 应 用 程序 会 把 这 些 对 象 作 为 不 可 变 对 象 处 理 。 比 
如 ， 你 不 应 该 对 作为 imm_timestamp 映射 的 Date 执 行 Date.setTime() 。 要 改 
ee ae 应 用 程序 必须 对 这 一 属性 重新 设置 一 个 新 的 (不 
一 样 的 ) 对 象 。 


实体 及 其 集合 的 唯一 标识 可 以 是 除了 binary 、 blob 和 clob 之 外 的 任何 基 
础 类 型 。( 联 合 标识 也 是 允许 的 ， 后 面 会 说 到 。 ) 


在 org.hibernate.Hibernate 中 ， 定义 了 基础 类 型 对 应 的 Type 常量 。 比 
如 ， Hibernate.STRING 代表 string 类 型 。 


5.2.3. 目 定 义 值 类 型 


开发 者 创建 属于 他 们 自己 的 值 类 型 也 是 很 容易 的 。 比 如 说 ， 你 可 能 希望 持久 

化 java.lang.BigInteger 类 型 的 属性 ， 持 久 化 成 为 VARCHAR 字段 。Hibernate 
没有 内 置 这 样 一 种 类 型 。 自 定义 类 型 能 够 映射 一 个 属性 (或 集合 元 素 ) 到 不 止 一 个 数 
据 库 表 字 段 。 比 如 说 ， 你 可 能 有 这 样 的 Java 属 性 : getName() / setName() ， 这 
是 java.lang.String 类 型 的 ， 对 应 的 持久 化 到 三 个 字段 : FIRST_NAME ， 
INITIAL ， SURNAME 。 


要 实现 一 个 自 定 义 类 型 ， 可 以 实 
m, org.hibernate.UserType 或 org.hibernate.CompositeUserType 中 的 任 一 


个 ， 并 且 使 用 类 型 的 Java 全 限定 类 名 来 定义 属性 。 请 查 
看 org.hibernate.test.DoubleStringType 这 个 例子 ， 看 看 它 是 怎么 做 的 。 


<property name="twoStrings" type="org.hibernate.test.DoubleStringT\ 
<column name="first_string"/> 
<column name="second_string"/> 

</property> 


‘J _ # 
注意 使 用 &1lt;columnagt; 标签 来 把 一 个 属性 映射 到 多 个 字段 的 做 法 。 


CompositeUserType , EnhancedUserType , UserCollectionType ,和 
UserVersionType 接口 为 更 特殊 的 使 用 方式 提供 支持 。 


你 甚至 可 以 在 一 个 映射 文件 中 提供 参数 给 一 个 UserType 。 为 了 这 样 做 ， 你 
必须 实现 org.hibernate.usertype.ParameterizedType 接口 。 
给 自 定 义 类 型 提供 参数 ， 你 可 以 在 映射 文件 中 使 用 &1t;type&gt; 元 素 。 





<property name="priority"> 
<type name="com.mycompany.usertypes.DefaultValueIntegerType"> 
<param name="default">0</param> 
</type> 
</property> 


| 
现在 ， UserType 可 以 从 传人 的 Properties 对 象 中 得 到 default BANA. 


如 果 你 非常 频繁 地 使 用 某 一 UserType ， 可 以 为 他 定义 一 个 简称 。 这 可 以 通过 使 用 
&lt;typedefagt; 元 素来 实现 。Typedefs 为 一 自 定 义 类 型 赋予 一 个 名 称 ， 并 且 如 
果 此 类 型 是 参 数 化 的 ， 还 可 以 包含 一 系列 默认 的 参数 值 。 


<typedef class="com.mycompany.usertypes.DefaultValueIntegerType" ni 
<param name="default">0</param> 
</typedef> 


al _ # 








<property name="priority" type="default_zero"/> 


也 可 以 根据 具体 案例 通过 属性 映射 中 的 类 型 参数 覆盖 在 typedef 中 提供 的 参数 。 


RÆ Hibernate 内 建 的 丰富 的 类 型 和 对 组 件 的 支持 意味 着 你 可 能 很 少 需要 使 用 自 定 
义 类 型 。 不 过 ， 为 那些 在 你 的 应 用 中 经 常 出 现 的 ( 非 实 体 ) 类 使 用 自 定义 类 型 也 是 一 
个 好 方法 。 例 如 ， 一 个 MonetaryAmount 类 使 用 compositeUserType 来 映射 是 
不 错 的 选择 ， 虽 然 他 可 以 很 容易 地 被 映射 成 组 件 。 这 样 做 的 动机 之 一 是 抽象 。 使 用 
自 定义 类 型 ， 以 后 假若 你 改变 表示 金额 的 方法 时 ， 它 可 以 保证 映射 文件 不 需要 修 
改 。 


多 次 映射 同一 个 类 


对 特定 的 持久 化 类 ， 了 映射 多 次 是 允许 的 。 这 种 情形 下 ， 你 必须 指定 entity name 来 区 

别 不 同 映 射 实体 的 对 象 实例 。 (默认 情况 下 ， 实 体 名 字 和 类 名 是 相同 的 。) 
Hibemate 在 扣 作 持 久 化 对 象 、 编 写 查 询 条 件 ， 或 者 把 关联 映射 到 指定 实体 时 ， 人 允许 
你 指定 这 个 entity name (实体 名 字 ) 。 


<class name="Contract" table="Contracts" 
entity-name="CurrentContract"> 


<set name="history" inverse="true" 
order -by="effectiveEndDate desc"> 
<key column="currentContractiId"/> 
<one-to-many entity-name="HistoricalContract"/> 
</set> 
</class> 


<class name="Contract" table="ContractHistory" 
entity-name="HistoricalContract"> 


<many-to-one name="CurrentContract" 
column="currentContractId" 
entity-name="CurrentContract"/> 
</class> 


N 


主意 这 里 关联 是 如 何 用 entity-name 来 代替 class 的 。 


5.4. SQL 中 引号 包围 的 标识 符 


你 可 通过 在 映射 文档 中 使 用 反 向 引号 

( ) 把 表 名 或 者 字段 名 包围 起 来 ， 以 强制 Hibernate 在 生成 的 SQL 中 把 标识 符 用 引号 包围 起 来 。 
Dialect (方言 ) 来 使 用 正确 的 引号 风格 (通常 是 双 引 号 ， 但 是 在 SQL Server 中 是 括 

号 ，MySQL 中 是 反 向 引号 )。 


<class name="LineItem" table=" Line Item "> 
<id name="id" column=" Item Id°"/><generator class="assigned"/: 
<property name="itemNumber" column=" Item #`"/> 


</class> 





5.5. 其 他 元 数据 (Metadata) 


XML 并 不 适用 于 所 有 人 , 因此 有 其 他 定义 Hibernate O/R 映射 元 数据 (metadata) 的 方 
法 。 


5.5.1. 使 用 XDoclet 标记 


很 多 Hibernate 使 用 者 更 喜欢 使 用 XDoclet @hibernate.tags 将 映射 信息 直接 腐 入 
到 源 代码 中 。 我 们 不 会 在 本 文档 中 涉及 这 个 方法 ， 因 为 严格 说 来 ， 这 属于 XDoclet 
的 一 部 分 。 然 而 ， 我 们 包含 了 如 下 使 用 XDoclet 映 射 的 cat 类 的 例子 。 


package eg; 
import java.util.Set; 
import java.util.Date; 


Vas 
* @hibernate.class 
* table="CATS" 
a 
public class Cat { 
private Long id; // identifier 
private Date birthdate; 
private Cat mother; 
private Set kittens 
private Color color; 
private char sex; 
private float weight; 


JER 
* @hibernate.id 
* generator-class="native" 
* column="CAT_ID" 
2 
public Long getId() { 
return id; 


} 

private void setId(Long id) { 
this .id=id; 

} 

[ese 


* @hibernate.many-to-one 
* ~column="PARENT_ID" 
sy 
public Cat getMother() { 
return mother; 
} 


void setMother(Cat mother) { 
this.mother = mother; 


} 


JAS 
* @hibernate.property 
* column="BIRTH_DATE" 


aye 
public Date getBirthdate() { 
return birthdate; 
} 
void setBirthdate(Date date) { 
birthdate = date; 
} 


[fess 
* @hibernate. property 
* ~column="WEIGHT" 
we 
public float getWeight() { 
return weight; 


void setWeight(float weight) { 
this.weight = weight; 
} 


JRS 
* @hibernate.property 
* column="COLOR" 
* not-null="true" 
SJA 
public Color getColor() { 
return color; 


void setColor(Color color) { 
this.color = color; 
} 


JER 
* @hibernate.set 
* inverse="true" 
* order -by="BIRTH_DATE" 
* @hibernate.collection-key 
* ~column="PARENT_ID" 
* @hibernate.collection-one-to-many 
EA 
public Set getKittens() { 
return kittens; 
} 


void setKittens(Set kittens) { 
this.kittens = kittens; 
} 


// addKitten not needed by Hibernate 
public void addKitten(Cat kitten) { 
kittens.add(kitten); 


} 
/es 
* @hibernate.property 
* column="SEX" 
* not-null="true" 
* 


update="false" 


oye 
public char getSex() { 
return sex; 


void setSex(char sex) { 
this.sex=sex; 
} 


参考 Hibernate 网 站 更 多 的 Xdoclet 和 Hibernate 的 例子 


5.5.2. 使 用 JDK 5.0 的 注解 (Annotation) 


JDK 5.0 在 语言 级 别 引 入 了 XDoclet 风格 的 标注 ， 并 且 是 类 型 安全 的 ， 在 编译 期 进 
行 检 查 。 这 一 机 制 比 XDoclet 的 注解 更 为 强大 ， 有 更 好 的 工具 和 IDE 支 持 。 例 如 ， 
IntelliJ IDEA， 支 持 JDK 5.0 注 解 的 自动 完成 和 话 法 高 亮 。EJB 规 范 的 新 修订 版 
(JSR-220) 使 用 JDK 5.0 的 注解 作为 entity beans 的 主要 元 数据 (metadata) 机 制 。 
Hibernate 3 实现 了 JSR-220 (the persistence API)AY EntityManager ， 支 持 通过 
Hibernate Annotatons 包 定义 映射 元 数据 。 这 个 包 作 为 单独 的 部 分 下 载 ， 支 持 EJB3 
(JSR-220) 和 Hibernate3 的 元 数据 。 


这 是 一 个 被 注解 为 EJB entity bean 的 POJO 类 的 例子 


@Entity(access = AccessType.FIELD) 
public class Customer implements Serializable { 


@Id; 
Long id; 


String firstName; 
String lastName; 
Date birthday; 


@Transient 
Integer age; 


@Embedded 
private Address homeAddress; 


@OneToMany(cascade=CascadeType.ALL) 
@JoinColumn(name="CUSTOMER_ID" ) 
Set<Order> orders; 


// Getter/setter and business methods 


~ 


注意 : 对 JDK 5.0 注解 (和 JSR-220) 支 持 的 工作 仍然 在 进行 中 ,并 未 完成 。 更 多 细 
#242 ğ Hibernate Annotations 模块 。 


5.6. 数据 库 生 成 属性 (Generated Properties) 


Generated properties 指 的 是 其 值 由 数据 库 生 成 的 属性 。 一 般 来 说 ， 如 果 对 象 有 任 
何 属性 由 数据 库 生 成 值 ，Hibernate 应 用 程序 需要 进行 刷新 (refresh) 。 但 如 果 把 
属性 标明 为 generated， 就 可 以 转 由 Hibernate 来 负责 这 个 动作 。 实 际 上 。 对 定义 了 
generated properties 的 实体 ,每 当 Hibernate 执 行 一 条 SQL INSERT 或 者 UPDATE 语 
句 ， 会 立刻 执行 一 条 select 来 获得 生成 的 值 。 


被 标明 为 generated 的 属性 还 必须 是 non-insertable 和 non-updateable 的 。 只 有 第 
5.1.7 节 “ 版 本 (version) (Ty, $ 5.1.8 节 “timestamp (可 选 ” 和 第 5.1.9 节 
“property 可 以 被 标明 为 generated。 


never (默认 ) 标明 此 属性 值 不 是 从 数据 库 中 生成 。 


insert - 标明 此 属性 值 在 insert 的 时 候 生 成 ， 但 是 不 会 在 随后 的 update 时 重新 生 
成 。 上 比如 说 创建 日 期 就 轨 属 于 这 类 。 注 意 虽 然 第 5.1.7 节 “ 版 本 (version) (可 
选 ) 和 第 5.1.8 节 “timestamp (可 选 ) 属 性 可 以 被 标注 为 generated， 但 是 不 适用 这 
个 选项 .… 


always - 标明 此 属性 值 在 insert 和 update 时 都 会 被 生成 。 


5.7. 辅助 数据 库 对 象 (Auxiliary Database Objects) 


Allows CREATE and DROP of arbitrary database objects, in conjunction with 
Hibernate's schema evolution tools, to provide the ability to fully define a user 
schema within the Hibernate mapping files. Although designed specifically for 
creating and dropping things like triggers or stored procedures, really any SQL 
command that can be run viaa java.sql.Statement.execute() method is 
valid here (ALTERs, INSERTS, etc). There are essentially two modes for defining 
auxiliary database objects... 帮助 CREATE 和 DROP 任 意 数据 库 对 象 ， 与 Hibernate 
的 schema 交 互 工具 组 合 起 来 ， 可 以 提供 在 Hibernate 映 射 文件 中 完全 定义 用 户 
schema 的 能 力 。 虽然 这 是 为 创建 和 销毁 trigger( 触 发 器 ) 或 stored procedure( 存 储 
过 程 ) 等 特别 设计 的 ， 实 际 上 任何 可 以 在 java.sql.Statement.execute() 方法 
中 执行 的 SQL 命令 都 可 以 在 此 使 用 (比如 ALTER, INSERT， 等 等 ) 。 本 质 上 有 两 种 
模式 来 定义 辅助 数据 库 对 象 … 


第 一 种 模式 是 在 映射 文件 中 显 式 声明 CREATE 和 DROP 命 令 : 


<hibernate-mapping> 


<database-object> 
<create>CREATE TRIGGER my_trigger ...</create> 
<drop>DROP TRIGGER my_trigger</drop> 
</database-object> 
</hibernate-mapping> 


第 二 种 模式 是 提供 一 个 类 ， 这 个 类 知道 如 何 组 织 CREATE 和 DROP 命 令 。 这 个 特别 


类 必须 实现 org.hibernate.mapping.AuxiliaryDatabase0bject 接口 。 


<hibernate-mapping> 


<database-object> 
<definition class="MyTriggerDefinition"/> 
</database-object> 
</hibernate-mapping> 


还 有 ， 这 些 数据 库 对 象 可 以 特别 指定 为 仅 在 特定 的 方言 中 才 使 用 。 


<hibernate-mapping> 


<database-object> 
<definition class="MyTriggerDefinition"/> 
<dialect-scope name="org.hibernate.dialect.Oracle9Dialect", 
<dialect-scope name="org.hibernate.dialect.OracleDialect"/: 
</database-object> 
</hibernate-mapping> 


«| — 
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6.1. 持久 化 集合 类 (Persistent collections) 


<a class="calibre5 pcalibre pcalibre1" id="collections-persistent-translate- 
comment"></a>( 译 者 注 : 在 阅读 本 章 的 时 候 ， 以 后 整个 手册 的 阅读 过 程 中 ， 我 们 都 
会 面临 一 个 名 词 方面 的 问题 ， 那 就 是 “集合 "。"Collections" 和 "Set" 在 中 文 里 对 应 都 
被 翻译 为 集合 "， 但 是 他 们 的 含义 很 不 一 样 。Collections 是 一 个 超 集 ，Set 是 其 中 的 
一 种 。 大 部 分 情况 下 ， 本 译 稿 中 泛 指 的 未 加 英文 注 明 的 “集合 "， 都 应 当 理 解 

为 “Collections”。 在 有 些 二 者 同时 出 现 ， 可 能 造成 混淆 的 地 方 ， 我 们 用 "集合 类 "来 特 
指 "Collecions”,“ 集 合 (Set)" 来 指 "Set"， 一 般 都 会 在 后 面 的 括号 中 给 出 英文 。 希 望 大 
家 在 阅读 时 联系 上 下 文理 解 ， 不 要 造成 误解 。 与 此 同时 , “元 素 " 一 词 对 应 的 英 

文 “element"， 也 有 两 个 不 同 的 含义 。 其 一 为 集合 的 元 素 ， 是 内 存 中 的 一 个 变量 ; 另 
一 合 义 则 是 XML 文 档 中 的 一 个 标签 所 代表 的 元 素 。 也 请 注意 区 别 。 本 章 中 ,特别 是 
后 半 部 分 是 需要 反复 阅读 才能 理解 清楚 的 。 如 果 遇 到 任何 疑问 ,请 记 住 ,美文 版 本 的 
reference 是 惟一 标准 的 参考 资料 。) 


Hibernate 要 求 持 久 化 集合 值 字段 必须 声明 为 接口 ， 比 如 : 


public class Product { 
private String serialNumber; 
private Set parts = new HashSet(); 


public Set getParts() { return parts; } 

void setParts(Set parts) { this.parts = parts; } 

public String getSerialNumber() { return serialNumber; } 
void setSerialNumber(String sn) { serialNumber = sn; } 


实际 的 接口 可 能 是 java.util.Set , java.util.Collection , 
java.util.List , java.util.Map , java.util.SortedSet 
java.util.SortedMap 或 者 ... 任 何 你 喜欢 的 类 型 1 (" 任 何 你 喜欢 的 类 型 " 代表 你 

需要 编写 org.hibernate.usertype.UserCollectionType 的 实现 .) 


注意 我 们 是 如 何 用 一 个 Hashset 实例 来 初始 化 实例 变量 的 .这 是 用 于 初始 化 新 创建 
(尚未 持久 化 ) 的 类 实例 中 集合 值 属性 的 最 佳 方法 。 当 你 持久 化 这 个 实例 时 一 一 比如 
通过 调用 persist() 一 一 Hibernate 会 自动 把 Hashset 替换 为 Hibernate 自 己 
的 Set 实现 。 观 察 下 面 的 错误 : 





Cat cat = new DomesticCat(); 
Cat kitten = new DomesticCat(); 


Set kittens = new HashSet(); 

kittens.add(kitten); 

cat.setKittens(kittens); 

session.persist(cat); 

kittens = cat.getKittens(); //Okay, kittens collection is a Set 
(HashSet) cat.getKittens(); //Error! 


根据 不 同 的 接口 类 型 ， 被 Hibernate 注 射 的 持久 化 集合 类 的 表现 类 似 HashMap , 
HashSet , TreeMap , TreeSet or ArrayList 。 


集合 类 实例 具有 值 类 型 的 通常 行为 。 当 被 持久 化 对 象 引 用 后 ， 他 们 会 自动 被 持久 
化 ， 当 不 再 被 引用 后 ， 自 动 被 删除 。 假 若 实例 被 从 一 个 持久 化 对 象 传递 到 另 一 个 ， 
它 的 元 素 可 能 从 一 个 表 转 移 到 另 一 个 表 。 两 个 实体 不 能 共享 同一 个 集合 类 实例 的 引 
用 。 因 为 诡 层 关系 数据 库 模 型 的 原因 ， 集 合 值 属性 无 法 支持 空 值 语义 ; Hibernatext 
空 的 集合 引用 和 空 集合 不 加 区 别 。 


你 不 需要 过 多 的 为 此 担心 。 就 如 同 你 平时 使 用 普通 的 Java 集 合 类 一 样 来 使 用 持久 化 
集合 类 。 只 是 要 确认 你 理解 了 双向 关联 的 语义 (后 文 讨论 ) 。 


6.2. 集合 映射 ( Collection mappings ) 


用 于 映射 集合 类 的 Hibernate 映 射 元 素 取 决 于 接口 的 类 型 。 比 如 ， &lt;setagt; 
元 素 用 来 映射 Set 类 型 的 属性 。 


<class name="Product"> 
<id name="serialNumber" column="productSerialNumber"/> 
<set name="parts"> 
<key column="productSerialNumber" not-null="true"/> 
<one-to-many class="Part"/> 
</set> 
</class> 


FRY &lt;set&gt; ,还 有 &lt;list&gt; , &lt;mapagt; , &lt;bag&gt; 
&lt;array&gt; 和 &lt;primitive-array&gt; 映射 元 素 。 &lt;map&gt; B 
有 代表 性 : 


<map 
name="propertyName" 
table="table_name" 
schema="schema_name" 
lazy="true|extra| false" 
inverse="true|false" 
cascade="all|none|save-update|delete|all-delete-orphan|delete-« 
sort="unsorted|natural|comparatorClass" 
order -by="column_name asc|desc" 
where="arbitrary sql where condition" 
fetch="join|select |subselect" 
batch-size="N" 
access="field|property|ClassName" 
optimistic-lock="true|false" 
mutable="true| false" 
node="element-name|." 
embed-xml="true|false" 


> 
<key .... /> 
<map-key .... /> 
<element .... /> 


</map> 





name 集合 属性 的 名 称 


table 〈 可 选 一 一 默认 为 属性 的 名 称 ) 这 个 集合 表 的 名 称 (不 能 在 一 对 多 
的 关联 关系 中 使 用 ) 


schema (Jit) 表 的 schema 的 名 称 , 他 将 覆盖 在 根 元 素 中 定义 的 schema 


lazy (可 选 -- 默 认为 true) 可 以 用 来 关闭 延迟 加 载 (false)， 指 定 一 直 使 用 预 
先 抓 取 ,或 者 打开 "extra-lazy" 抓 取 ， 此 时 大 多 数 操作 不 会 初始 化 集合 类 (适用 
于 非常 大 的 集合 ) 

inverse (可 选 一 一 默认 为 false ) 标记 这 个 集合 作为 双向 关联 关系 中 的 
方向 一 端 。 

cascade (可 选 一 默认 为 none ) 让 操作 级 联 到 子 实体 

sort (可 选 ) 指 定 集合 的 排序 顺序 , 其 可 以 为 自然 的 ( natural ) 或 者 给 定 一 
个 用 来 比较 的 类 。 

order-by (可 选 , 仅 用 于 jdk1.4) 指定 表 的 字段 (一 个 或 几 个 ) 再 加 上 asc 或 者 
desc( 可 选 ), 定义 Map,Set 和 Bag 的 迭代 顺序 


where (可 选 ) 指定 任意 的 SQL where 条 件 , 该 条 件 将 在 重新 载 入 或 者 删除 
这 个 集合 时 使 用 ( 当 集 合 中 的 数据 仅仅 是 所 有 可 用 数据 的 一 个 子 集 时 这 个 条 件 
非常 有 用 ) 


fetch (可 选 , 默认 为 select ) 用 于 在 外 连接 抓 取 、 通 过 后 续 select 抓 取 
和 通过 后 续 subselect 抓 取 之 间 选 择 。 


batch-size (Ait, 默认 为 1 ) 指定 通过 延迟 加 载 取得 集合 实例 的 批 处 理 
块 大 小 ("batch size") 。 


access (可 选 -默认 为 属性 property):Hibernate 取 得 集合 属性 值 时 使 用 的 策 
略 


乐观 锁 (可 选 - 默认 为 true ): 对 集合 的 状态 的 改变 会 是 否 导 致 其 所 属 的 
实体 的 版 本 增长 。 (对 一 对 多 关联 来 说 ， 关 闭 这 个 属性 常常 是 有 理 的 ) 
mutable( 可 变 ) (可 选 - 默认 为 true ) 若 值 为 false ,表明 集合 中 的 元 
素 不 会 改变 (在 某 些 情况 下 可 以 进行 一 些小 的 性 能 优化 ) 。 


6.2.1. 集合 外 键 (Collection foreign keys) 


合 实例 在 数据 库 中 依靠 持 有 集合 的 实体 的 外 键 加 以 辨别 。 此 外 键 作 为 集合 关键 字 
段 (collection key column) (或 多 个 字段 ) 加 以 引用 。 集 合 关 键 字段 通 
过 &lt;key&gt; 元 素 映 射 。 


在 外 键 字段 上 可 能 具有 非 空 约束 。 对 于 大 多 数 集合 来 说 ， 这 是 隐 含 的 。 对 单 向 一 对 
多 关联 来 说 ， 外 键 字 段 默 认 是 可 以 为 空 的 ， 因 此 你 可 能 需要 指明 


not-null="true" 。 


<key column="productSerialNumber" not-null="true"/> 


外 键 约束 可 以 使 用 ON DELETE CASCADE 。 


<key column="productSerialNumber" on-delete="cascade"/> 


对 &lt;keyagt; 元 素 的 完整 定义 ， 请 参阅 前 面 的 章节 。 


6.2.2. 集合 元 素 (Collection elements) 


合 几乎 可 以 包含 任何 其 他 的 Hibernate 类 型 ， 包 括 所 有 的 基本 类 型 、 自 定义 类 型 、 
组 件 ， 当 然 还 有 对 其 他 实体 的 引用 。 存 在 一 个 重要 的 区 别 : 位 于 集合 中 的 对 象 可 能 
是 根据 “ 值 " 语 义 来 操作 (其 声明 周期 完全 依赖 于 集合 持 有 者 ) ， 或 者 它 可 能 是 指向 
另 一 个 实体 的 引用 ， 具 有 其 自己 的 生命 周期 。 在 后 者 的 情况 下 ， 被 作为 集合 持 有 的 
状态 考虑 的 ， 只 有 两 个 对 象 之 间 的 "连接 ”。 


被 包容 的 类 型 被 称 为 集合 元 素 类 型 (collection element type) 。 集 合 元 素 通 

过 &lt;element&gt; 或 &lt;composite-element&gt; 映射 ， 或 在 其 是 实体 引 
用 的 时 候 ， 通 过 &lt;one-to-many&gt; 或 &lt;many-to-many&gt; 映射。 前 两 
种 用 于 使 用 值 语义 映射 元 素 ， 后 两 种 用 于 映射 实体 关联 。 


6.2.3. 来 引 集 合 类 (Indexed collections) 


所 有 的 集合 映射 ， 除 了 set 和 bag 语 义 的 以 外 ， 都 需要 指定 一 个 集合 表 的 索引 字段 
(index column) 一 一 用 于 对 应 到 数组 索引 ， 或 者 List 的 索引 ， 或 者 Map 的 关键 
字 。 通 过 @lt;map-key&gt; , Map 的 索引 可 以 是 任何 基础 类 型 ; 若 通 

过 &lt;map-key-many-to-many&gt; ， 它 也 可 以 是 一 个 实体 引用 ; 若 通 

过 &lt;composite-map-key&gt; ， 它 还 可 以 是 一 个 组 合 类 型 。 数 组 或 列表 的 索 
引 必须 是 integer 类 型 ， 并 且 使 用 &lt;list-index&gt; 元 素 定 义 映 射 。 被 映 
射 的 字段 包含 有 顺序 排列 的 整数 〈 黑 认 从 0 开始 ) 。 





<map - key 
column="column_name" 
formula="any SQL expression" 
type="type_name" 
node="@attribute-name" 
length="N"/> 


0 column (可 选 ): 保 存 集合 索引 值 的 字段 名 。 
@ formula (可 选 ): 用 于 计算 map 关 键 字 的 SQL 公式 
© type (必须 ): 映 射 键 (map key) 的 类 型 。 
<map-key-many-to-many 

column="column_name" 


formula="any SQL expression" 
class="ClassName" 


/> 
0 column (T4) FARMS RAF RAM 
@ formula (可 选 ): 用 于 计算 map 关 键 字 的 外 键 的 SQL 公式 


© class (必需 ): 映 射 的 键 (map key) 使 用 的 实体 类 。 


假若 你 的 表 没 有 一 个 素 引 字段 , 当 你 仍然 希望 使 用 List 作为 属性 类 型 ,你 应 该 把 此 
属性 映射 为 Hibernate <bag>。 从 数据 库 中 获取 的 时 候 ，bag 不 维护 其 顺序 ， 但 也 可 
选择 性 的 进行 排序 。 


从 集合 类 可 以 产生 很 大 一 部 分 映射 ， 履 盖 了 很 多 音 见 的 关系 模型 。 我 们 建议 你 试验 
schema 生 成 工具 ， 来 体会 一 下 不 同 的 映射 声明 是 如 何 被 翻译 为 数据 库 表 的 。 


6.2.4. 值 集合 于 多 对 多 关联 (Collections of values 
and many-to-many associations) 


任何 值 集合 或 者 多 对 多 关联 需要 专用 的 具有 一 个 或 多 个 外 键 字 段 的 collection 
table、 一 个 或 多 个 collection element column， 以 及 还 可 能 有 一 个 或 多 个 索引 字 
段 。 


对 于 一 个 值 集 合 , 我 们 使 用 &lt;elementagt; 标签 。 


<element 
column="column_name" 
formula="any SQL expression" 
type="typename" 
length="L" 
precision="P" 
scale="S" 
not-null="true|false" 
unique="true|false" 
node="element -name" 


/> 

0 column (可 选 ): 保 存 集合 元 素 值 的 字段 名 。 
@ formula (可 选 ): 用 于 计算 元 素 的 SQL 公式 
© type (必需 ): 集 合 元 素 的 类 型 


多 对 多 关联 (many-to-many association) 使 用 &1lt;many-to-many&gt; 元 素 定义 . 


<many-to-many 
column="column_name" 
formula="any SQL expression" 
class="ClassName" 
fetch="select|join" 
unique="true|false" 
not -found="ignore|exception" 
entity-name="EntityName" 
property-ref="propertyNameFromAssociatedClass" 
node="element -name" 
embed-xml="true|false" 

/> 


© column (可 选 ): 这 个 元 素 的 外 键 关键 字段 名 
@ formula (可 选 ): 用 于 计算 元 素 外 键 值 的 SQL 公 式 . 
© class (必需 ): 关联 类 的 名 称 


outer-join (可 选 - 默认 为 auto ): 在 Hibernate 系 统 参 数 
© + hibernate.use_outer_join 被 打开 的 情况 下 ,该 参数 用 来 允许 使 用 
outer join 来 载 入 此 集合 的 数据 。 


为 此 关联 打开 外 连接 抓 取 或 者 后 续 select 抓 取 。 这 是 特殊 情况 ; 对 于 一 个 实 
A 体 及 其 指向 其 他 实体 的 多 对 多 关联 进 全 预先 抓 取 〈 使 用 一 pan 

的 SELECT )， 你 不 仅 需要 对 集合 自身 打开 join ， 也 需要 

对 &lt;many-to-many&gt; 这 个 内 入 元 素 打 开 此 属性 。 

对 外 键 字段 允许 DDL 生 成 的 时 候 生 成 一 个 惟一 约束 。 这 使 关联 变 成 了 一 个 高 
© 效 的 一 对 多 关联 。 (此 名 存疑 : 原文 为 This makes the association 

multiplicity effectively one to many.) 


not-found (可 选 - 默认 为 ”exception ): e 
FMR: ignore 会 把 缺失 的 行 作 为 一 个 空 引用 人 处理 。 


@ entity-name (Fit): 被 关联 的 类 的 实体 名 ， 作 为 class WER. 


property-ref : (可 选 ) 被 关联 到 此 外 键 (foreign key) 的 类 中 的 对 应 属性 的 
名 字 。 若 未 指定 ， 使 用 被 关联 类 的 主键 。 


例子 : 首先 , 一 组 字符 串 : 


© 


<set name="names" table="NAMES"> 

<key column="GROUPID"/> 

<element column="NAME" type="string"/> 
</set> 


包含 一 组 整数 的 bag( 还 设置 了 order-by 参数 指定 了 和 迭代 的 顺序 ) : 


<bag name="sizes" 
table="item_sizes" 
order-by="size asc"> 
<key column="item_id"/> 
<element column="size" type="integer"/> 
</bag> 


一 个 实体 数组 ,在 这 个 案例 中 是 一 个 多 对 多 的 关联 (注意 这 里 的 实体 是 自动 管理 生命 
周期 的 对 象 (lifecycle objects) , cascade="all" ): 


<array name="addresses" 
table="PersonAddress" 
cascade="persist"> 
<key column="personId"/> 
<list-index column="sortOrder"/> 
<many-to-many column="addressId" class="Address"/> 
</array> 


一 个 map, 通 过 字符 串 的 索引 来 指明 日 期 : 


<map name="holidays" 
table="holidays" 
schema="dbo" 
order -by="hol_name asc"> 
<key column="id"/> 
<map-key column="hol_name" type="string"/> 
<element column="hol_date" type="date"/> 
</map> 


一 个 组 件 的 列表 : 〈 下 一 章 讨 论 ) 


<list name="carComponents" 
table="CarComponents"> 
<key column="carId"/> 
<list-index column="sortOrder"/> 
<composite-element class="CarComponent"> 
<property name="price"/> 
<property name="type"/> 
<property name="SerialNumber" column="sSerialNum"/> 
</composite-element> 
</list> 


6.2.5. 一 对 多 关联 (One-to-many Associations) 


一 对 多 关联 ”通过 外 键 连接 两 个 类 对 应 的 表 , 而 没有 中 间 集 合 表 。 这 个 关系 模型 失 
去 了 一 些 Java 集 合 的 语义 : 


。 一 个 被 包含 的 实体 的 实例 只 能 被 包含 在 一 个 集合 的 实例 中 
。 一 个 被 包含 的 实体 的 实例 只 能 对 应 于 集合 索引 的 一 个 值 中 


一 个 从 Product 到 Part 的 关联 需要 关键 字 字 段 ,可 能 还 有 一 个 索引 字段 指 
向 Part 所 对 应 的 表 。 &lt;one-to-many&gt; 标记 指明 了 一 个 一 对 多 的 关联 。 


<one-to-many 
class="ClassName" 
not-found="ignore|exception" 
entity-name="EntityName" 
node="element-name" 
embed-xml="true|false" 
/> 


© class (必须 ): 被 关联 类 的 名 称 。 


not-found (可 选 - 默认 为 exception ): 指明 若 缓 存 的 标示 值 关 联 的 行 缺 
失 , 该 如 何 处 理 : ignore 会 把 缺失 的 行 作 为 一 个 空 关联 处 理 。 


© entity-name (可 选 ): 被 关联 的 类 的 实体 名 ， 作 为 class WBR., 


@ 


例子 


<set name="bars"> 

<key column="foo_id"/> 

<one-to-many class="org.hibernate.Bar"/> 
</set> 


注意 : &lt;one-to-many&gt; 元 素 不 需要 定义 任何 字段 。 也 不 需要 指定 表 名 。 


重要 提示 :如 果 一 对 多 关联 中 的 外 键 字段 定义 成 NOT NULL ,你 必须 
把 alt;key&gt; 映射 声明 为 not-null="true" ,或 者 使 用 双向 关联 ， 并 且 标 
HA inverse="true" 。 参 阅 本 章 后 面 关 于 双向 关联 的 讨论 。 


下 面 的 例子 展示 一 个 Part 实体 的 map, 把 name 作 为 关键 字 。( partName 
是 Part 的 持久 化 属性 )。 注 意 其 中 的 基于 公式 的 索引 的 用 法 。 


<map name="parts" 
cascade="all"> 
<key column="productId" not-null="true"/> 
<map-key formula="partName"/> 
<one-to-many class="Part"/> 
</map> 


6.3. 高 级 集合 映射 (Advanced collection 
mappings) 


6.3.1. 有 序 集合 (Sorted collections) 


Hibernate 支 持 实现 java.util.SortedMap 和 java.util.Sortedset 的 集合 。 
你 必须 在 映射 文件 中 指定 一 个 比较 器 : 


<set name="aliases" 
table="person_aliases" 
sort="natural"> 
<key column="person"/> 
<element column="name" type="string"/> 
</set> 


<map name="holidays" sort="my.custom.HolidayComparator"> 
<key column="year_id"/> 
<map-key column="hol_name" type="string"/> 
<element column="hol_date" type="date"/> 

</map> 


sort 属性 中 人 允许 的 值 包 括 unsorted , natural 和 某 个 实现 
了 java.util.Comparator 的 类 的 名 称 。 


分 类 集合 的 行为 事实 上 象 java.util.TreeSet 或 者 java.util.Treemap o 


如 果 你 希望 数据 库 自 己 对 集合 元 素 排序 ， 可 以 利用 set , bag 或 者 map 映射 中 
的 order-by 属性 。 这 个 解决 方案 只 能 在 jdk1.4 或 者 更 高 的 jdk 版 本 中 才 可 以 实现 
(通过 LinkedHashSet 或 者 LinkedHashMap 实 现 )。 它 是 在 SQL 查 询 中 完成 排序 ， 而 
不 是 在 内 存 中 。 


<Set name="aliases" table="person_aliases" order-by="lower(name) a: 
<key column="person"/> 
<element column="name" type="string"/> 

</set> 


<map name="holidays" order-by="hol_date, hol_name"> 
<key column="year_id"/> 
<map-key column="hol_name" type="string"/> 
<element column="hol_date" type="date"/> 

</map> 





注意 : 这 个 order-by 属性 的 值 是 一 个 SQL 排序 子 句 而 不 是 HQL 的 ! 
关 还 可 以 在 运行 时 使 用 集合 filter() 根据 任意 的 条 件 来 排序 。 


sortedUsers = s.createFilter( group.getUsers(), "order by this.name 


‘ ay 








6.3.2. 双向 关联 (Bidirectional associations) 


双向 关联 人 允许 通过 关联 的 任 一 端 访问 另外 一 端 。 在 Hibernate 中 , 支持 两 种 类 型 的 双 
向 关联 : 


一 对 多 (one-to-many) 

Set 或 者 bag 值 在 一 端 , 单独 值 ( 非 集合 ) 在 另外 一 端 
多 对 多 (many-to-many) 

两 端 都 是 set 或 bag 值 


要 建立 一 个 双向 的 多 对 多 关联 ， 只 需要 映射 两 个 many-to-many 关 联 到 同一 个 数据 库 
表 中 ， 并 再 定义 其 中 的 一 端 为 /mnverse( 使 用 哪 一 端 要 根据 你 的 选择 ， 但 它 不 能 是 一 
个 索引 集合 )。 


这 里 有 一 个 many-to-many 的 双向 关联 的 例子 ;每 一 个 category 都 可 以 有 很 多 items ,每 
一 个 items 可 以 属于 很 多 categories : 


<class name="Category"> 
<id name="id" column="CATEGORY_ID"/> 


<bag name="items" table="CATEGORY_ITEM"> 
<key column="CATEGORY_ID"/> 
<many-to-many class="Item" column="ITEM_ID"/> 
</bag> 
</class> 


<class name="Item"> 
<id name="id" column="CATEGORY_ID"/> 


<!-- inverse end --> 
<bag name="categories" table="CATEGORY_ITEM" inverse="true"> 
<key column="ITEM_ID"/> 
<many-to-many class="Category" column="CATEGORY_ID"/> 
</bag> 
</class> 


如 果 只 对 关联 的 反 向 端 进 行 了 改变 ， 这 个 改变 不 会 被 持久 化 。 这 表示 Hibernate 为 
每 个 双向 关联 在 内 存 中 存在 两 次 表现 ,一 个 从 A 连接 到 B, 另 一 个 从 B 连 接 到 A。 如 果 你 
回想 一 下 Java 对 象 模型 ， 我 们 是 如 何在 Java 中 创建 多 对 多 关系 的 ， 这 可 以 让 你 更 容 
易 理解 : 


category.getItems().add(item); // The category now "knows' 


item.getCategories().add(category); // The item now "knows" 

session.persist(item); // The relationship won''t 

session.persist(category); // The relationship will | 
‘| 7 _ : 





非 反 向 端 用 于 把 内 存 中 的 表示 保存 到 数据 库 中 。 


要 建立 一 个 一 对 多 的 双向 关联 ， 你 可 以 通过 把 一 个 一 对 多 关联 ， 作 为 一 个 多 对 一 关 





联 映射 到 到 同一 张 表 的 字段 上 ， 并 且 在 "多 "的 那 一 端 定义 inverse="true" 。 


<class name="Parent"> 
<id name="id" column="parent_id"/> 


<set name="children" inverse="true"> 
<key column="parent_id"/> 
<one-to-many class="Child"/> 
</set> 
</class> 


<class name="Child"> 
<id name="id" column="child_id"/> 


<many-to-one name="parent" 
class="Parent" 
column="parent_id" 
not -null="true"/> 
</class> 


在 “一 ”这 一 端 定 义 inverse="true" 不 会 影响 级 联 操作 ， 


二 者 是 正 交 的 概念 ! 


6.3.3. 双向 关联 ， 涉 及 有 序 集合 类 


对 于 有 一 端 是 &1t;1ist&gt; 或 者 &1t;map&gt; 的 双向 关联 ， 需 要 加 以 特别 考 
虑 。 假 若 子 类 中 的 一 个 属性 映射 到 索引 字段 ， 没 问题 ， 我 们 仍然 可 以 在 集合 类 映射 
上 使 用 inverse="true" 


<class name="Parent"> 
<id name="id" column="parent_id"/> 


<map name="Children" inverse="true"> 
<key column="parent_id"/> 
<map-key column="name" 
type="string"/> 
<one-to-many class="Child"/> 
</map> 
</class> 


<class name="Child"> 
<id name="id" column="child_id"/> 


<property name="name" 
not -null="true"/> 
<many-to-one name="parent" 
class="Parent" 
column="parent_id" 
not -null="true"/> 
</class> 


但 是 ， 假 若 子 类 中 没有 这 样 的 属性 存在 ， 我 们 不 能 认为 这 个 关联 是 真正 的 双向 关联 
(信息 不 对 称 ， 在 关联 的 一 端 有 一 些 另外 一 端 没 有 的 信息 ) 。 在 这 种 情况 下 ， 我 们 
不 能 使 用 inverse="true" 。 我 们 需要 这 样 用 : 


<class name="Parent"> 
<id name="id" column="parent_id"/> 


<map name="children"> 
<key column="parent_id" 
not -null="true"/> 
<map-key column="name" 
type="string"/> 
<one-to-many class="Child"/> 
</map> 
</class> 


<class name="Child"> 
<id name="id" column="child_id"/> 


<many-to-one name="parent" 
class="Parent" 
column="parent_id" 
insert="false" 
update="false" 
not -null="true"/> 
</class> 


注意 在 这 个 映射 中 ， 关 联 中 集合 类 " 值 " 一 端 负责 来 更 新 外 键 .TODO: Does this really 
result in some unnecessary update statements? 


6.3.4. 三 重 关 联 (Ternary associations) 


有 三 种 可 能 的 途径 来 映射 一 个 三 重 关 联 。 第 一 种 是 使 用 一 个 Map ， 把 一 个 关联 作 
为 其 索引 : 


<map name="contracts"> 
<key column="employer_id" not-null="true"/> 
<map-key-many-to-many column="employee_id" class="Employee"/> 
<one-to-many class="Contract"/> 

</map> 


LE 省 :. 吧 | 
<map name="connections"> 
<key column="incoming_node_id"/> 
<map-key-many-to-many column="outgoing_node_id" class="Node"/> 


<many-to-many column="connection_id" class="Connection"/> 
</map> 


二 
第 二 种 方法 是 简单 的 把 关联 重新 建 模 为 一 个 实体 类 。 这 使 我 们 最 经 常 使 用 的 方法 。 
最 后 一 种 选择 是 使 用 复合 元 素 ， 我 们 会 在 后 面 讨论 


6.3.5. 使 用 &lLt;idbag&gt ; 


如 果 你 完全 信奉 我 们 对 于 “联合 主键 (composite keys) 是 个 坏 东 西 "” 和 “实体 应 该 
使 用 (无 机 的 ) 自己 生成 的 代用 标识 符 (surrogate keys) "的 观点 ， 也 许 你 会 感到 
有 一 些 奇怪 ， 我 们 目前 为 止 展示 的 多 对 多 关联 和 值 集合 都 是 映射 成 为 带 有 联合 主键 
的 表 的 ! 现在 ， 这 一 点 非常 值得 争辩 ; 看 上 去 一 个 单纯 的 关联 表 并 不 能 从 代用 标识 
符 中 获得 什么 好 处 (虽然 使 用 组 合 值 的 集合 可 能 会 获得 一 点 好 处 ) 。 不 过 ， 


到 一 个 使 用 代用 标识 符 的 表 去 。 
&lt;idbag&gt; 属性 让 你 使 用 bag 语 义 来 映射 一 个 List (或 Collection )。 


<idbag name="lovers" table="LOVERS"> 
<collection-id column="ID" type="long"> 
<generator class="sSequence"/> 
</collection-id> 
<key column="PERSON1"/> 
<many-to-many column="PERSON2" class="Person" fetch="join"/> 
</idbag> 


你 可 以 理解 ， &lt;idbag&gt， 人工 的 id 生成 器 ， 就 好 像 是 实体 类 一 样 1 集合 的 每 
一 行 都 有 一 个 不 同 的 人 造 关 键 字 。 但 是 ，Hibernate 没 有 提供 任何 机 制 来 让 你 取得 某 
个 特定 行 的 人 造 关 键 字 。 


注意 &1t;idbag&gt; 的 更 新 性 能 要 上 比 普 通 的 &1t ;bag&gt; 高 得 多 ! Hibernate 可 
以 有 效 的 定位 到 不 同 的 行 ， 分 别 进行 更 新 或 删除 工作 ， 就 如 同人 处 理 一 个 list, map 或 
者 set 一 样 。 


在 目前 的 实现 中 ， 还 不 支持 使 用 identity 标识 符 生 成 器 策略 来 生 
成 &1t;idbag&gt; 集合 的 标识 符 。 


6.4. 集合 例子 (Collection example) 
在 前 面 的 几 个 章节 的 确 非常 合 人 迷惑 。 因此 让 我 们 来 看 一 个 例子 。 这 个 类 : 


package eg; 
import java.util.Set; 


public class Parent { 
private long id; 
private Set children; 


public long getId() { return id; } 
private void setId(long id) { this.id=id; } 


private Set getChildren() { return children; } 
private void setChildren(Set children) { this.children=childrer 





这 个 类 有 一 个 Child 的 实例 集合 。 如 果 每 一 个 子 实 例 至 多 有 一 个 父 实例 , 那么 最 自 
然 的 映射 是 一 个 one-to-many 的 关联 关系 : 


<hibernate-mapping> 


<class name="Parent"> 
<id name="id"> 
<generator class="sSequence"/> 
</id> 
<set name="children"> 
<key column="parent_id"/> 
<one-to-many class="Child"/> 
</set> 
</class> 


<class name="Child"> 
<id name="id"> 
<generator class="Ssequence"/> 
</id> 
<property name="name"/> 
</class> 


</hibernate-mapping> 


在 以 下 的 表 定 义 中 反应 了 这 个 映射 关系 : 


create table parent ( id bigint not null primary key ) 
create table child ( id bigint not null primary key, name varchar (: 
alter table child add constraint childfkO (parent_id) references pi 


i 
如 果 父 亲 是 必须 的 , 那么 就 可 以 使 用 双向 one-to-many 的 关联 了 : 


‘| 








<hibernate-mapping> 


<class name="Parent"> 
<id name="id"> 
<generator class="Ssequence"/> 
</id> 
<set name="cChildren" inverse="true"> 
<key column="parent_id"/> 
<one-to-many class="Child"/> 
</set> 
</class> 


<class name="Child"> 
<id name="id"> 
<generator class="sequence"/> 
</id> 
<property name="name"/> 
<many-to-one name="parent" class="Parent" column="parent_ic 
</class> 


</hibernate-mapping> 


El -k 





sa 


请 注意 NOT NULL 的 约束 : 


create table parent ( id bigint not null primary key ) 
create table child ( id bigint not null 
primary key, 
name varchar(255), 
parent_id bigint not null ) 
alter table child add constraint childfkO (parent_id) references pi 





另外 ， 如 果 你 绝对 坚持 这 个 关联 应 该 是 单 向 的 ， 你 可 以 对 &1t;key&gt; 映射 声 
BA NOT NULL 约束 : 


<hibernate-mapping> 


<class name="Parent"> 
<id name="id"> 
<generator class="sequence"/> 
</id> 
<set name="children"> 
<key column="parent_id" not-null="true"/> 
<one-to-many class="Child"/> 
</set> 
</class> 


<class name="Child"> 
<id name="id"> 
<generator class="sequence"/> 
</id> 
<property name="name"/> 
</class> 


</hibernate-mapping> 


另外 一 方面 ,如 果 一 个 子 实例 可 能 有 多 个 父 实例 , 那么 就 应 该 使 用 many-to-many 关 


联 : 


<hibernate-mapping> 


<class name="Parent"> 
<id name="id"> 
<generator class="sequence"/> 
</id> 
<set name="children" table="childset"> 
<key column="parent_id"/> 
<many-to-many class="Child" column="child_id"/> 
</set> 
</class> 


<class name="Child"> 
<id name="id"> 
<generator class="sSequence"/> 
</id> 
<property name="name"/> 
</class> 


</hibernate-mapping> 


表 定 义 : 


create table parent ( id bigint not null primary key ) 
create table child ( id bigint not null primary key, name varchar (: 
create table childset ( parent_id bigint not null, 

child_id bigint not null, 

primary key ( parent_id, child_id ) ) 
alter table childset add constraint childsetfkO (parent_id) referer 
alter table childset add constraint childsetfk1 (child_id) referenc 








更 多 的 例子 ,以 及 一 个 完整 的 父 / 子 关 系 映 射 的 排练 ,请 参阅 第 21 章 示例 : 父子 关系 
(Parent Child Relationships). 


ORE BS RARER SE RS PUMA Bete. 


第 7 章 天 联 天 系 映射 


目录 


e 7.1. 
e 7.2. 


o 
N 


o 
N 


o 
N 


o 
N 


Mo00M00fR0000W0 


fe} 


(0) 


介绍 

单 向 关联 (Unidirectional associations) 
7.2.1. 多 对 一 (many to one) 

7.2.2. 一 对 一 (one to one) 

7.2.3. 一 对 多 (one to many) 


. 使 用 连接 表 的 单 向 关联 (Unidirectional associations with join tables) 


7.3.1. 一 对 多 (one to many) 
7.3.2. 多 对 一 (many to one) 
7.3.3. 一 对 一 (one to one) 
7.3.4. 多 对 多 (many to many) 


. 双向 关联 (Bidirectional associations) 


7.4.1. 一 对 多 (one to many) / 多 对 一 (many to one) 
7.4.2. 一 对 一 (one to one) 


. 使 用 连接 表 的 双向 关联 (Bidirectional associations with join tables) 


7.5.1. 一 对 多 (one to many) /多 对 一 ( many to one) 
7.5.2. 一 对 一 (one to one) 
7.5.3. 多 对 多 (many to many) 


. 更 复杂 的 关联 映射 


7.1. 介绍 


关联 关系 映射 通常 情况 是 最 难 配置 正确 的 。 在 这 个 部 分 中 ， 我 们 从 单 向 关系 映射 开 
始 ， 然 后 考虑 双向 关系 映射 ， 由 浅 至 深 讲 述 一 表 典 型 的 案例 。 在 所 有 的 例子 中 ， 我 
们 都 使 用 Person 和 Address 。 


我 们 根据 映射 关系 是 否 涉 及 连接 表 以 及 多 样 性 来 划分 关联 类 型 。 


在 传统 的 数据 建 模 中 ， 人 允许 为 Null 值 的 外 键 被 认为 是 一 种 不 好 的 实践 ， 因 此 我 们 所 
有 的 例子 中 都 使 用 不 允许 为 Null 的 外 键 。 这 并 不 是 Hibernate 的 要 求 ， 即 使 你 删除 掉 
不 允许 为 Null 的 约束 ，Hibernate 映 射 一 样 可 以 工作 的 很 好 。 


7.2. 单 向 关联 (Unidirectional associations) 


7.2.1. 多 对 一 (many to one) 
单 向 many-to-one 关 联 是 最 常见 的 单 向 关联 关系 。 


<class name="Person"> 
<id name="id" column="personId"> 
<generator class="native"/> 
</id> 
<many-to-one name="address" 
column="addressId" 
not -null="true"/> 
</class> 


<class name="Address"> 
<id name="id" column="addressId"> 
<generator class="native"/> 
</id> 
</class> 


create table Person ( personId bigint not null primary key, addres: 
create table Address ( addressId bigint not null primary key ) 


BES 





7.2.2. 一 对 一 (one to one) 


基于 外 键 关 联 的 单 向 一 对 一 关联 和 单 向 多 对 一 关联 几乎 是 一 样 的 。 唯 一 的 不 同 就 是 
单 向 一 对 一 关联 中 的 外 键 字段 具有 唯一 性 约束 。 


<class name="Person"> 
<id name="id" column="personId"> 
<generator class="native"/> 
</id> 
<many-to-one name="address" 
column="addressId" 
unique="true" 
not-null="true"/> 
</class> 


<class name="Address"> 
<id name="id" column="addressId"> 
<generator class="native"/> 
</id> 
</class> 


create table Person ( personId bigint not null primary key, addres: 
create table Address ( addressId bigint not null primary key ) 





基于 主键 关联 的 单 向 一 对 一 关联 通常 使 用 一 个 特定 的 id 生成 器 。 GER, Ea 
例子 中 我 们 掉 换 了 关联 的 方向 。 ) 


<class name="Person"> 
<id name="id" column="personId"> 
<generator class="native"/> 
</id> 
</class> 


<class name="Address"> 
<id name="id" column="personId"> 
<generator class="foreign"> 
<param name="property">person</param> 
</generator> 
</id> 
<one-to-one name="person" constrained="true"/> 
</class> 


create table Person ( personId bigint not null primary key ) 
create table Address ( personId bigint not null primary key ) 


7.2.3. 一 对 多 (one to many) 
基于 外 键 关联 的 单 向 一 对 多 关联 是 一 种 很 少见 的 情况 ， 并 不 推荐 使 用 。 


<class name="Person"> 
<id name="id" column="personId"> 
<generator class="native"/> 
</id> 
<set name="addresses"> 
<key column="personId" 
not -null="true"/> 
<one-to-many class="Address"/> 
</set> 
</class> 


<class name="Address"> 
<id name="id" column="addressId"> 
<generator class="native"/> 
</id> 
</class> 


create table Person ( personId bigint not null primary key ) 
create table Address ( addressId bigint not null primary key, pers 


JE 
我 们 认为 对 于 这 种 关联 关系 最 好 使 用 连接 表 。 





7.3. 使 用 连接 表 的 单 向 关联 (Unidirectional 


associations with join tables) 


7.3.1. 一 对 多 (one to many) 


基于 连接 表 的 单 向 一 对 多 关联 应 该 优先 被 采用 。 请 注意 ， 通 过 指 
定 unique="true" ， 我 们 可 以 把 多 样 性 从 多 对 多 改变 为 一 对 多 。 


<class name="Person"> 
<id name="id" column="personId"> 
<generator class="native"/> 
</id> 
<set name="addresses" table="PersonAddress"> 
<key column="personId"/> 
<many-to-many column="addressId" 
unique="true" 
class="Address"/> 
</set> 
</class> 


<class name="Address"> 
<id name="id" column="addressId"> 
<generator class="native"/> 
</id> 
</class> 


create table Person ( personId bigint not null primary key ) 
create table PersonAddress ( personId not null, addressId bigint nc 
create table Address ( addressId bigint not null primary key ) 
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7.3.2. 多 对 一 (many to one) 
基于 连接 表 的 单 向 多 对 一 关联 在 关联 关系 可 选 的 情况 下 应 用 也 很 普通 。 


<class name="Person"> 
<id name="id" column="personId"> 
<generator class="native"/> 
</id> 
<join table="PersonAddress" 
optional="true"> 
<key column="personId" unique="true"/> 
<many-to-one name="address" 
column="addressId" 
not -null="true"/> 
</join> 
</class> 


<class name="Address"> 
<id name="id" column="addressId"> 
<generator class="native"/> 
</id> 
</class> 


create table Person ( personId bigint not null primary key ) 
create table PersonAddress ( personId bigint not null primary key, 
create table Address ( addressId bigint not null primary key ) 
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7.3.3. 一 对 一 (one to one) 
基于 连接 表 的 单 向 一 对 一 关联 非常 少见 ， 但 也 是 可 行 的 。 


<class name="Person"> 
<id name="id" column="personId"> 
<generator class="native"/> 
</id> 
<join table="PersonAddress" 
optional="true"> 
<key column="personId" 
unique="true"/> 
<many-to-one name="address" 
column="addressId" 
not -null="true" 
unique="true"/> 
</join> 
</class> 


<class name="Address"> 
<id name="id" column="addressId"> 
<generator class="native"/> 
</id> 
</class> 


create table Person ( personId bigint not null primary key ) 
create table PersonAddress ( personId bigint not null primary key, 
create table Address ( addressId bigint not null primary key ) 


E] 





7.3.4. 多 对 多 (many to many) 
最 后 ， 还 有 单 向 多 对 多 关联 ， 


<class name="Person"> 
<id name="id" column="personId"> 
<generator class="native"/> 
</id> 
<set name="addresses" table="PersonAddress"> 
<key column="personId"/> 
<many-to-many column="addressId" 
class="Address"/> 
</set> 
</class> 


<class name="Address"> 
<id name="id" column="addressId"> 
<generator class="native"/> 
</id> 
</class> 


create table Person ( personId bigint not null primary key ) 
create table PersonAddress ( personId bigint not null, addressId b: 
create table Address ( addressId bigint not null primary key ) 
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7.4. 双向 关联 (Bidirectional associations) 


7.4.1. 一 对 多 (one to many) / 多 对 一 (many to 
one) 


双向 多 对 一 关联 是 最 常见 的 关联 关系 。 (这 也 是 标准 的 父 / 子 关联 关系 。) 


<class name="Person"> 
<id name="id" column="personId"> 
<generator class="native"/> 
</id> 
<many-to-one name="address" 
column="addressId" 
not-null="true"/> 
</class> 


<class name="Address"> 
<id name="id" column="addressId"> 
<generator class="native"/> 
</id> 
<set name="people" inverse="true"> 
<key column="addressId"/> 
<one-to-many class="Person"/> 
</set> 
</class> 


create table Person ( personId bigint not null primary key, addres: 
create table Address ( addressId bigint not null primary key ) 


E E) 


如 果 你 使 用 List (或 者 其 他 有 序 集合 类 )， 你 需要 设置 外 键 对 应 的 key 列 为 
not null ,让 Hibernate 来 从 集合 端 管理 关联 ， 维 护 每 个 元 素 的 索引 (通过 设 
i update="false" and insert="false" 来 对 另 一 端 反 向 操作 ) 。 





<class name="Person"> 
<id name="id"/> 


<many-to-one name="address" 
column="addressId" 
not -null="true" 
insert="false" 
update="false"/> 
</class> 


<class name="Address"> 
<id name="id"/> 


<list name="people"> 
<key column="addressId" not-null="true"/> 
<list-index column="peopleIdx"/> 
<one-to-many class="Person"/> 
</list> 
</class> 


假若 集合 映射 的 &lt;key&gt; 元 素 对 应 的 底层 外 键 字段 是 NOT NULL AY, BAH 
这 一 key 元 素 定 义 not-null="true" 是 很 重要 的 。 不 要 久 公 为 可 能 的 蔡 

Æ &1lt;column&gt; 元 素 定 义 not-nul1="true" , &lt;keyagt; 元 素 也 是 需 
要 的 。 


7.4.2. 一 对 一 (one to one) 
基于 外 键 关 联 的 双向 一 对 一 关联 也 很 常见 。 


<class name="Person"> 
<id name="id" column="personId"> 
<generator class="native"/> 
</id> 
<many-to-one name="address" 
column="addressId" 
unique="true" 
not -null="true"/> 
</class> 


<class name="Address"> 
<id name="id" column="addressId"> 
<generator class="native"/> 
</id> 
<one-to-one name="person" 
property-ref="address"/> 
</class> 


create table Person ( personId bigint not null primary key, addres: 
create table Address ( addressId bigint not null primary key ) 


El —— 
基于 主键 关联 的 一 对 一 关联 需要 使 用 特定 的 id 生成 器 。 





<class name="Person"> 
<id name="id" column="personId"> 
<generator class="native"/> 
</id> 
<one-to-one name="address"/> 
</class> 


<class name="Address"> 
<id name="id" column="personId"> 
<generator class="foreign"> 
<param name="property">person</param> 
</generator> 
</id> 
<one-to-one name="person" 
constrained="true"/> 
</class> 


create table Person ( personId bigint not null primary key ) 
create table Address ( personId bigint not null primary key ) 


7.5. 使 用 连接 表 的 双 同 关联 (Bidirectional 
associations with join tables) 


7.5.1. 一 对 多 (one to many) /多 对 一 (many to 
one) 


基于 连接 表 的 双向 一 对 多 关联 。 注 意 inverse="true" 可 以 出 现在 关联 的 任意 一 
端 ， 即 collection 端 或 者 join 端 。 


<class name="Person"> 
<id name="id" column="personId"> 
<generator class="native"/> 
</id> 
<set name="addresses" 
table="PersonAddress"> 
<key column="personId"/> 
<many-to-many column="addressId" 
unique="true" 
class="Address"/> 
</set> 
</class> 


<class name="Address"> 
<id name="id" column="addressId"> 
<generator class="native"/> 
</id> 
<join table="PersonAddress" 
inverse="true" 
optional="true"> 
<key column="addressId"/> 
<many-to-one name="person" 
column="personId" 
not -null="true"/> 
</join> 
</class> 


create table Person ( personId bigint not null primary key ) 
create table PersonAddress ( personId bigint not null, addressId b: 
create table Address ( addressId bigint not null primary key ) 





7.5.2. 一 对 一 (one to one) 
基于 连接 表 的 双向 一 对 一 关联 极为 罕见 ， 但 也 是 可 行 的 。 


<class name="Person"> 
<id name="id" column="personId"> 
<generator class="native"/> 
</id> 
<join table="PersonAddress" 
optional="true"> 
<key column="personId" 
unique="true"/> 
<many-to-one name="address" 
column="addressId" 
not -null="true" 
unique="true"/> 
</join> 
</class> 


<class name="Address"> 
<id name="id" column="addressId"> 
<generator class="native"/> 
</id> 
<join table="PersonAddress" 
optional="true" 
inverse="true"> 
<key column="addressId" 
unique="true"/> 
<many-to-one name="person" 
column="personId" 
not-null="true" 
unique="true"/> 
</join> 
</class> 


create table Person ( personId bigint not null primary key ) 
create table PersonAddress ( personId bigint not null primary key, 
create table Address ( addressId bigint not null primary key ) 
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7.5.3. 多 对 多 (many to many) 
最 后 ， 还 有 双向 多 对 多 关联 . 


<class name="Person"> 
<id name="id" column="personId"> 
<generator class="native"/> 
</id> 
<set name="addresses" table="PersonAddress"> 
<key column="personId"/> 
<many-to-many column="addressId" 
class="Address"/> 
</set> 
</class> 


<class name="Address"> 
<id name="id" column="addressId"> 
<generator class="native"/> 
</id> 
<set name="people" inverse="true" table="PersonAddress"> 
<key column="addressId"/> 
<many-to-many column="personId" 
class="Person"/> 
</set> 
</class> 


create table Person ( personId bigint not null primary key ) 
create table PersonAddress ( personId bigint not null, addressId b: 
create table Address ( addressId bigint not null primary key ) 
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7.6. 更 复杂 的 关联 映射 


更 复杂 的 关联 连接 极为 罕见 。 通过 在 映射 文档 中 窜 入 SQL 片 断 ，Hibernate 也 可 以 
处 理 更 为 复杂 的 情况 。 上 比如 ， 假 若 包 含 历史 帐户 数据 的 表 定 义 了 accountNumber , 
effectiveEndDate 和 effectiveStartDate 字段 ， 按 照 下 面 映 射 : 


<properties name="currentAccountKey"> 
<property name="accountNumber" type="String" not-null="true"/> 
<property name="currentAccount" type="boolean"> 

<formula>case when effectiveEndDate is null then 1 else 0 4 

</property> 

</properties> 

<property name="effectiveEndDate" type="date"/> 

<property name="effectiveStateDate" type="date" not-null="true"/> 


[E E) 


那么 我 们 可 以 对 目前 (current) 实 例 (其 effectiveEndDate 为 nu 由 使 用 这 样 的 关联 
映射 : 





<many-to-one name="currentAccountInfo" 
property-ref="currentAccountKey" 
class="AccountIinfo"> 
<column name="accountNumber"/> 
<formula>'1'</formula> 
</many - to-one> 


更 复杂 的 例子 ,假想 Employee 和 Organization 之 间 的 关联 是 通过 一 
个 Employment 中 间 表 维护 的 ,而 中 间 表 中 填充 了 很 多 万 史 展 员 数 据 。 那 “ 屋 员 的 最 
新 殿 主 "这 个 关联 (最 新 屠 主 就 是 startDate 最 后 的 那个 ) 可 以 这 样 映射 : 


<join> 
<key column="employeeId"/> 
<subselect> 
select employeelId, orgId 
from Employments 
group by orgId 
having startDate = max(startDate) 
</subselect> 
<many-to-one name="mostRecentEmployer" 
class="Organization" 
column="orgId"/> 
</join> 


使 用 这 一 功能 时 可 以 充满 创意 ， 但 通常 更 加 实用 的 是 用 HQL 或 条 件 查询 来 义理 这 些 


情形 。 


第 8 章 组 件 (Component) 映射 
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组 件 (Component) 这 个 概念 在 Hibernate 中 几 久 不 同 的 地 方 为 了 不 同 的 目的 被 重复 使 
用 . 


8.1. 依赖 对 象 (Dependent objects) 


组 件 (Component) 是 一 个 被 包含 的 对 象 ， 在 持久 化 的 过 程 中 ， 它 被 当 作 值 类 型 ， 而 
并 非 一 个 实体 的 引用 。 在 这 篇 文档 中 ， 组 件 这 一 术语 指 的 是 面向 对 象 的 合成 概念 
(而 并 不 是 系统 构架 层次 上 的 组 件 的 概念 ) 。 举 个 例子 , 你 对 人 (Person) 这 个 概念 5 
以 像 下 面 这 样 来 建 模 : 


public class Person { 
private java.util.Date birthday; 
private Name name; 
private String key; 
public String getKey() { 
return key; 
} 


private void setkey(String key) { 
this.key=key; 
} 


public java.util.Date getBirthday() { 
return birthday; 


public void setBirthday(java.util.Date birthday) { 
this.birthday = birthday; 


public Name getName() { 
return name; 


public void setName(Name name) { 
this.name = name; 


public class Name { 
char initial; 
String first; 
String last; 
public String getFirst() { 
return first; 


void setFirst(String first) { 
this.first = first; 


} 
public String getLast() { 
return last; 


void setLast(String last) { 
this.last = last; 


public char getInitial() { 
return initial; 


void setInitial(char initial) { 
this.initial = initial; 
} 


在 持久 化 的 过 程 中 ,姓名 (Name) 可 以 作为 人 (Person) 的 一 个 组 件 。 需 要 注意 的 
是 :你 应 该 为 姓名 的 持久 化 属性 定义 getter 和 setter 方 法 ,但 是 你 不 需要 实现 任何 的 
接口 或 申明 标识 符 字 段 。 


以 下 是 这 个 例子 的 Hibernate 映 射 文件 : 
<class name="eg.Person" table="person"> 


<id name="Key" column="pid" type="string"> 
<generator class="uuid"/> 


</id> 
<property name="birthday" type="date"/> 
<component name="Name" class="eg.Name"> <!-- class attribute or 


<property name="initial"/> 
<property name="first"/> 
<property name="last"/> 
</component> 
</class> 
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人 员 (Person) 表 中 将 包括 pid, birthday , initial , first 和 last 等 字 
Jb 
又 o 


就 像 所 有 的 值 类 型 一 样 , 组 件 不 支持 共享 引用 。 换 名 话说， 两 个 人 可 能 重 名 ， 但 是 
两 个 Person 对 象 应 该 包含 两 个 独立 的 Name 对 象 ， 只 不 过 这 两 个 Name 对 象 具有 "“ 同 
样 " 的 值 。 组 件 的 值 可 以 为 空 ， 其 定义 如 下 。 每 当 Hibernate 重 新 加 载 一 个 包含 组 件 


的 对 象 ,如 果 该 组 件 的 所 有 字段 为 空 ，Hibernate 将 假定 整个 组 件 为 空 。 在 大 多 数 情 
况 下 ,这 样 假定 应 该 是 没有 问题 的 。 


组 件 的 属性 可 以 是 任意 一 种 Hibernate 类 型 (包括 集合 , 多 对 多 关联 ， 以 及 其 它 组 件 
EE) 。 旋 套 组 件 不 应 该 被 当 作 一 种 特殊 的 应 用 (Nested components should not 
be considered an exotic usage), Hibernate 倾 向 于 支持 细致 的 (fine-grained) 对 象 
模型 。 


&lt;component&gt; 元 素 还 允许 有 &lt;parent&gt; 子 元 素 ， 用 来 表明 
component 类 中 的 一 个 属性 是 指向 包含 它 的 实体 的 引用 。 


<class name="eg.Person" table="person"> 
<id name="Key" column="pid" type="string"> 
<generator class="uuid"/> 
</id> 
<property name="birthday" type="date"> 
<component name="Name" class="eg.Name" unique="true"> 
<parent name="namedPerson"/> <!-- reference back to the Pet 
<property name="initial"/> 
<property name="first"/> 
<property name="last"/> 
</componentégt ; 
</class> 





8.2. 在 集合 中 出 现 的 依赖 对 象 (Collections of 
dependent objects) 


Hibernate 支 持 组 件 的 集合 (例如 : 一 个 元 素 是 姓名 (Name) 这 种 类 型 的 数组 )。 你 可 以 
使 用 &lt;composite-element&gt; 标签 蔡 代 &lt;elementagt; 标签 来 定义 你 
的 组 件 集 合 。 


<set name="someNames" table="some names" lazy="true"> 
<key column="id"/&gt; 
<composite-element class="eg.Name"> <!-- class attribute requii 
<property name="initial"/> 
<property name="first"/> 
<property name="last"/>; 
</composite-element> 
</set> 





注意 ， 如 果 你 定义 的 Set 包 含 组 合 元 素 (composite-element)， 正 确 地 实 
现 equals() 和 hashcode() 是 非常 重要 的 。 


组 合 元 素 可 以 包含 组 件 ， 但 是 不 能 包含 集合 。 如 果 你 的 组 合 元 素 自 身 包含 组 件 , 你 
必须 使 用 &lt;nested-composite-element&gt; 标签 。 这 是 一 个 相当 特殊 的 案例 
- 在 一 个 组 件 的 集合 里 ， 那 些 组 件 本 身 又 可 以 包含 其 他 的 组 件 。 这 个 时 候 你 就 应 该 
考虑 一 下 使 用 one-to-many 关 联 是 否 会 更 恰当 。 尝试 对 这 个 组 合 元 素 重新 建 模 为 一 
个 实体 一 但 是 需要 注意 的 是 ， 虽 然 Java 模 型 和 重新 建 模 前 是 一 样 的 ， 关 系 模型 和 持 
久 性 语义 会 有 细微 的 变化 。 


请 注意 如 果 你 使 用 &lLt;set&gt; 标签 ,一 个 组 合 元 素 的 映射 不 支持 可 能 为 空 的 属 

性 . 当 删 除 对 象 时 ， Hibernate 必 须 使 用 每 一 个 字段 的 值 来 确定 一 条 记录 (在 组 合 元 
素 表 中 ， 没 有 单独 的 关键 字段 )， 如 果 有 为 null 的 字段 ， 这 样 做 就 不 可 能 了 。 你 必须 
作出 一 个 选择 ， 要 么 在 组 合 元 素 中 使 用 不 能 为 空 的 属性 ， 要 么 选择 使 

用 &lt;list&gt; , &lt;map&gt; , &lt;bagagt; 或 者 alt;idbag&gt; 而 不 

是 &lt;set&gt; 。 


组 合 元 素 有 个 特别 的 用 法 是 它 可 以 包含 一 个 &lt;many-to-oneagt; JGR. 类似 这 
样 的 映射 允许 你 将 一 个 many-to-many 关 联 表 映射 为 组 合 元 素 的 集合 。(A mapping 
like this allows you to map extra columns of a many-to-many association table to 
the composite element class.) 接 下 来 的 的 例子 是 从 Order 到 Item 的 一 个 多 对 
多 的 关联 关系 , 关联 属性 是 purchaseDate , price 和 quantity 。 


<class name="eg.Order" .... > 


<set name="purchasedItems" table="purchase_items" lazy="true"> 


<key column="order_id"> 
<composite-element class="eg.Purchase"> 
<property name="purchaseDate"/> 
<property name="price"/> 
<property name="quantity"/> 
<many-to-one name="item" class="eg.Item"/> <!-- class é 
</composite-element> 
</set> 
</class> 


加 
当然 ， 当 你 定义 ltem 时 ， 你 无 法 引用 这 些 purchase， 因 此 你 无 法 实现 双向 关联 查 
询 。 记 住 组 件 是 值 类 型 ， 并 且 不 允许 共享 引用 。 某 一 个 特定 的 Purchase 可 以 放 
在 order 的 集合 中 ， 但 它 不 能 同时 被 Item 所 引用 。 


其 实 组 合 元 素 的 这 个 用 法 可 以 扩展 到 三 重 或 多 重 关联 : 





<class name="eg.Order" .... > 


<set name="purchasedItems" table="purchase_items" lazy="true"> 


<key column="order_id"> 
<composite-element class="eg.OrderLine"> 
<many-to-one name="purchaseDetails" class="eg.Purchase' 


<many-to-one name="item" class="eg.Item"/> 
</composite-element> 
</set> 
</class> 


En 


在 查询 中 ， 表 达 组 合 元 素 的 语法 和 关联 到 其 他 实体 的 语法 是 一 样 的 。 





8.3. 组 件 作 为 Map 的 索引 (Components as Map 
indices ) 


&1lt;composite-map-key&gt; 元 素 允 许 你 映射 一 个 组 件 类 作为 一 个 Map 的 
key， 前 提 是 你 必须 正确 的 在 这 个 类 中 重 写 了 hashcode() 和 equals() 方法 。 


8.4. 组 件 作为 联合 标识 符 (Components as 
composite identifiers) 


你 可 以 使 用 一 个 组 件 作 为 一 个 实体 类 的 标识 符 。 你 的 组 件 类 必须 满足 以 下 要 求 : 
e 它 必 须 实现 java.io.Serializable 接口 


o 它 必须 重新 实现 equals() 和 hashCode() 方法 , 始终 和 组 合 关键 字 在 数据 库 
中 的 概念 保持 一 致 


注意 : 在 Hibernate3 中 ， 第 二 个 要 求 并 非 是 Hibernate 强 制 必 须 的 。 但 最 好 这 样 做 。 


你 不 能 使 用 一 个 IdentifierGenerator 产生 组 合 关 键 字 。 一 个 应 用 程序 必须 分 配 
它 自 己 的 标识 符 。 


使 用 &lt;composite-id&gt; #mA(# AWN alt;key-property&gt; 元 素 ) 代 
蔡 通 常 的 alt;idagt; 标签 。 上 比如 ，OrderLine 类 具有 一 个 主键 ， 这 个 主键 依赖 
于 Order 的 (联合 ) 主 键 。 


<class name="OrderLine"> 


<composite-id name="id" class="OrderLineId"> 
<key-property name="lineId"/> 
<key-property name="orderId"/> 
<key-property name="customerId"/> 
</composite-id> 


<property name="name"/> 


<many-to-one name="order" class="Order" 
insert="false" update="false"> 
<column name="orderId"/> 
<column name="customerId"/> 
</many - to-one> 


</class> 


现在 ， 任 何 指向 OrderLine 的 外 键 都 是 复合 的 。 在 你 的 映射 文件 中 ， 必 须 为 其 他 
类 也 这 样 声明 。 例 如 ， 一 个 指向 orderLine 的 关联 可 能 被 这 样 映射 : 


<many-to-one name="orderLine" class="OrderLine"> 
<!-- the "class" attribute is optional, as usual --> 
<column name="lineId"/> 
<column name="orderId"/> 
<column name="CustomerId"/> 
</many - to-one> 


(注意 在 各 个 地 方 alt;columnagt; 标签 都 是 colum 属性 的 替代 写法 。) 


指向 orderLine 的 多 对 多 关联 也 使 用 联合 外 键 : 


<set name="undeliveredOrderLines"> 
<key column name="warehouseld"/> 
<many-to-many class="OrderLine"> 
<column name="lineId"/> 
<column name="orderiId"/> 
<column name="customerId"/> 
</many -to-many> 
</set> 


在 Order P, OrderLine 的 集合 则 是 这 样 : 


<Set name="orderLines" inverse="true"> 
<key> 
<column name="orderId"/> 
<column name="CcustomerId"/> 
</key> 
<one-to-many class="OrderLine"/> 
</set> 


(与 通常 一 样 ，&1lt ;one-to-many&gt; 元 素 不 声明 任何 列 .) 
假若 orderLine 本 身 拥有 一 个 集合 , 它 也 具有 组 合 外 键 。 


<class name="OrderLine"> 


<list name="deliveryAttempts"> 

<key> <!-- a collection inherits the composite key type - 
<column name="lineId"/> 
<column name="orderId"/> 
<column name="CcustomerId"/> 

</key> 

<list-index column="attemptId" base="1"/> 

<composite-element class="DeliveryAttempt"> 


</composite-element> 
</set> 
</class> 





8.5. 动态 组 件 (Dynamic components) 
你 甚至 可 以 映射 Map 类 型 的 属性 : 


<dynamic-component name="userAttributes"> 
<property name="foo" column="FOO" type="string"/> 
<property name="bar" column="BAR" type="integer"/> 
<many-to-one name="baz" class="Baz" column="BAZ_ID"/> 
</dynamic -component> 


从 &lt;dynamic-component&gt， 了 映射 的 语义 上 来 讲 ， 它 

和 &1t;component&gt; 是 相同 的 。 这 种 映射 类 型 的 优点 在 于 通过 修改 映射 文 
件 ， 就 可 以 具有 在 部 署 时 检测 真实 属性 的 能 力 。 利 用 一 个 DOM 解 析 器 ， 也 可 以 在 程 
序 运行 时 操作 映射 文件 。 更 好 的 是 ， 你 可 以 通过 Configuration 对 象 来 访问 (或 
者 修改 ) Hibernate 的 运行 时 元 模型 。 


第 9 章 继承 映射 (Inheritance Mappings) 
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9.1. 三 种 策略 


Hibernate 支 持 三 种 基本 的 继承 映射 策略 : 
。 每 个 类 分 层 结构 一 张 表 (table per class hierarchy) 
。 每 个 子 类 一 张 表 (table per subclass) 
每 个 具体 类 一 张 表 (table per concrete class) 
此 外 ，Hibernate 还 支持 第 四 种 稍 有 不 同 的 多 态 映 射 策略 : 
e KAZ A(implicit polymorphism) 


对 于 同一 个 继承 层次 内 的 不 同 分 支 ， el shat 然后 用 隐 式 多 AR 
完成 跨越 整个 层次 的 多 态 。 但 是 在 同一 个 &1t;class&gt; 根 元 素 下 ，Hibernate 
不 支持 混合 了 元 素 a ee ee ; 

&lt;joined-subclass&gt; 和 &lt;union-subclass&gt; 的 映射 。 在 同一 

个 &lt;classagt; 元 素 下 ， 可 以 混合 使 用 “每 个 类 分 层 结构 一 张 表 ”(table per 
hierarchy) 和 “每 个 子 类 一 张 表 ”(table per subclass) 这 两 种 映射 策略 ， 这 是 通过 
结合 元 素 &lt;subclass&gt; 和 &lt;join&gt， 来 实现 的 〈 见 后 ) o 


在 多 个 映射 文件 中 ， 可 以 直接 在 hibernate-mapping 根 下 定 

sL subclass ， union-subclass 和 joined-subclass 。 也 就 是 说 ， 你 可 以 仅 
加 入 一 个 新 的 映射 文件 来 扩展 类 层次 。 你 必须 在 subclass 的 映射 中 指 

BA extends 属性 ， 给 出 一 个 之 前 定义 的 超 类 的 名 字 。 注 意 ， 在 以 前 ， 这 一 功能 对 
映射 文件 的 顺序 有 严格 的 要 求 ， 从 Hibernate 3 开始 ， 
对 映射 文件 的 顺序 不 再 有 要 求 ; 但 在 每 个 映射 文件 里 ， 超 类 必须 在 子 类 之 前 定义 。 


<hibernate-mapping> 
<subclass name="DomesticCat" extends="Cat" discriminator -value 
<property name="name" type="string"/> 
</subclass> 
</hibernate-mapping> 


-| ë B 





9.1.1. 每 个 类 分 层 结构 一 张 表 (Table per class 
hierarchy) 


假设 我 们 有 接口 Payment 和 它 的 几 个 实现 类 : CreditCardPayment , 
CashPayment ,和 ChequePayment 。 则 “每 个 类 分 层 结构 一 张 表 ”(Table per class 
hierarchy) 的 映射 代码 如 下 所 示 : 


<class name="Payment" table="PAYMENT"> 
<id name="id" type="long" column="PAYMENT_ID"> 
<generator class="native"/> 
</id> 
<discriminator column="PAYMENT_TYPE" type="string"/> 
<property name="amount" column="AMOUNT"/> 


<subclass name="CreditCardPayment" discriminator -value="CREDIT' 
<property name="creditCardType" column="CCTYPE"/> 


</subclass> 
<subclass name="CashPayment" discriminator -value="CASH"> 


</subclass> 
<subclass name="ChequePayment" discriminator -value="CHEQUE"> 


</subclass> 
</class> 


HE 


采用 这 种 策略 只 需要 一 张 表 即 可 。 它 有 一 个 很 大 的 限制 : 要 求 那 些 由 子 类 定义 的 字 
段 ， 如 ccTYPE ， 不 能 有 非 空 (NOT NULL) 约束 。 





9.1.2. 每 个 子 类 一 张 表 (Table per subclass) 
对 于 上 例 中 的 几 个 类 而 言 ， 采 用 "每 个 子 关 一 张 表 " 的 映射 策略 ， 代 码 如 下 所 示 : 


<class name="Payment" table="PAYMENT"> 
<id name="id" type="long" column="PAYMENT_ID"> 
<generator class="native"/> 
</id> 
<property name="amount" column="AMOUNT"/> 


<joined-subclass name="CreditCardPayment" table="CREDIT_PAYMEN 
<key column="PAYMENT_ID"/> 


</joined-subclass> 

<joined-subclass name="CashPayment" table="CASH_PAYMENT"> 
<key column="PAYMENT_ID"/> 
<property name="creditCardType" column="CCTYPE"/> 


</joined-subclass> 
<joined-subclass name="ChequePayment" table="CHEQUE_PAYMENT"> 
<key column="PAYMENT_ID"/> 


</joined-subclass> 
</class> 


| = Z 


需要 四 张 表 。 三 个 子 类 表 通 过 主键 关联 到 超 类 表 ( 因 而 关系 模型 实际 上 是 一 对 一 关 
联 )。 





9.1.3. 每 个 子 类 一 张 表 (Table per subclass)， 使 用 
H Al +r (Discriminator) 


注意 ， 对 “每 个 子 类 一 张 表 ” 的 映射 策略 ，Hibernate 的 实现 不 需要 辨别 字段 ， 而 其 他 
的 对 象 /关系 映射 工具 使 用 了 一 种 不 同 于 Hibernate 的 实现 方法 ， 该 方法 要 求 在 超 类 
表 中 有 一 个 类 型 辨别 字段 (type discriminator column)。Hibernate 采 用 的 方法 更 难 
实现 ， 但 从 关系 (数据 库 ) 的 角度 来 看 ， 按 理 说 它 更 正确 。 若 你 愿意 使 用 带 有 辨别 
F 段 的 “每 个 子 类 一 张 表 ” 的 策略 ， 你 可 以 结合 使 用 &1t; subclass&gt; 

与 &lt;join&gt; ， 如 下 所 示 : 


<class name="Payment" table="PAYMENT"> 
<id name="id" type="long" column="PAYMENT_ID"> 
<generator class="native"/> 
</id> 
<discriminator column="PAYMENT_TYPE" type="string"/> 
<property name="amount" column="AMOUNT"/> 


<subclass name="CreditCardPayment" discriminator -value="CREDIT' 
<join table="CREDIT_PAYMENT"> 
<key column="PAYMENT_ID"/> 
<property name="creditCardType" column="CCTYPE"/> 


</join> 
</subclass> 
<subclass name="CashPayment" discriminator -value="CASH"> 
<join table="CASH_PAYMENT"> 
<key column="PAYMENT_ID"/> 


</join> 
</subclass> 
<subclass name="ChequePayment" discriminator -value="CHEQUE"> 
<join table="CHEQUE_PAYMENT" fetch="Select"> 
<key column="PAYMENT_ID"/> 


</join> 
</subclass> 
</class> 


= 人。 


可 选 的 声明 fetch="select" ， 是 用 来 告诉 Hibernate， 在 查询 超 类 时 ， 不 要 使 用 
外 部 连接 (outer join) 来 抓 取 子 类 chequePayment 的 数据 。 





9.1.4. 混合 使 用 “每 个 类 分 层 结构 一 张 表 ”和 “每 个 子 
类 一 张 表 ” 


eas 下 方法 混和 使 用 “每 个 类 分 层 结构 一 张 表 "和 “每 个 子 类 一 张 表 "这 两 
种 


<class name="Payment" table="PAYMENT"> 
<id name="id" type="Long" column="PAYMENT_ID"> 
<generator class="native"/> 
</id> 
<discriminator column="PAYMENT_TYPE" type="string"/> 
<property name="amount" column="AMOUNT"/> 


<subclass name="CreditCardPayment" discriminator -value="CREDIT' 
<join table="CREDIT_PAYMENT"> 
<property name="creditCardType" column="CCTYPE"/> 
</join> 
</subclass> 
<subclass name="CashPayment" discriminator -value="CASH"> 


</subclass> 
<subclass name="ChequePayment" discriminator -value="CHEQUE"> 


</subclass> 
</class> 





对 上 述 任何 一 种 映射 策略 而 言 ， 指 向 根 类 Payment 的 关联 是 使 
FA &lt;many-to-one&gt; 进行 映射 的 。 


<many-to-one name="payment" column="PAYMENT_ID" class="Payment"/> 


E | 


9.1.5. 每 个 具体 类 一 张 表 (Table per concrete 
class) 


对 于 “每 个 具体 类 一 张 表 "的 映射 策略 ， 可 以 采用 两 种 方法 。 第 一 种 方法 是 使 用 


&lt;union-subclass&gt; o 


<class name="Payment"> 
<id name="id" type="long" column="PAYMENT_ID"> 
<generator class="Sequence"/> 
</id> 
<property name="amount" column="AMOUNT"/> 


<union-subclass name="CreditCardPayment" table="CREDIT_PAYMENT' 
<property name="creditCardType" column="CCTYPE"/> 


</union-subclass> 
<union-subclass name="CashPayment" table="CASH_PAYMENT"> 


</union-subclass> 
<union-subclass name="ChequePayment" table="CHEQUE_PAYMENT"> 


</union-subclass> 
</class> 


JE 


这 里 涉及 三 张 与 子 类 相关 的 表 。 每 张 表 为 对 应 类 的 所 有 属性 《包括 从 超 类 继承 的 属 
性 ) 定义 相应 字段 。 


这 种 方式 的 局 限 在 于 ， 如 果 一 个 属性 在 超 类 中 做 了 映射 ， 其 字段 名 必须 与 所 有 子 类 
表 中 定义 的 相同 。( 我 们 可 能 会 在 Hibernate 的 后 续 发 布 版 本 中 放宽 此 限制 。) 不 允许 
在 联合 子 类 (union subclass) 的 继承 层次 中 使 用 标识 生成 器 策略 (identity generator 
strategy), 实际 上 , 主键 的 种 子 (primary key seed) 不 得 不 为 同一 继承 层次 中 的 全 部 被 
联合 子 类 所 共用 . 


假若 超 类 是 抽象 类 ， 请 使 用 abstract="true" 。 当 然 ， 假 若 它 不 是 抽象 的 ， 需 要 
一 个 额外 的 表 (上 面 的 例子 中 ， 默 认 是 PAYMENT ) ， 来 保存 超 类 的 实例 。 





9.1.6. Table per concrete class, using implicit 
polymorphism 


另 一 种 可 供 选 择 的 方法 是 采用 隐 式 多 态 : 


<class name="CreditCardPayment" table="CREDIT_PAYMENT"> 
<id name="id" type="long" column="CREDIT_PAYMENT_ID"> 
<generator class="native"/> 
</id> 
<property name="amount" column="CREDIT_AMOUNT"/> 


</class> 
<class name="CashPayment" table="CASH_PAYMENT"> 
<id name="id" type="long" column="CASH_PAYMENT_ID"> 
<generator class="native"/> 


</id> 
<property name="amount" column="CASH_AMOUNT"/> 


</class> 
<class name="ChequePayment" table="CHEQUE_PAYMENT"> 
<id name="id" type="long" column="CHEQUE_PAYMENT_ID"> 
<generator class="native"/> 


</id> 
<property name="amount" column="CHEQUE_AMOUNT"/> 


</class> 


注意 ， 我 们 没有 在 任何 地 方 明 确 的 提 及 接口 Payment 。 同 时 注意 Payment 的 属 
性 在 每 个 子 类 中 都 进行 了 映射 。 如 果 你 想 避 免 重 复 ， 可 以 考虑 使 用 XML 实体 ( 例 
如 : 位 于 DOCTYPE 声明 内 的 

[ &lt;!ENTITY allproperties SYSTEM "allproperties.xml"agt; ] 和 映射 
中 的 &allproperties; )。 


这 种 方法 的 缺陷 在 于 ， 在 Hibernate 执 行 多 态 查 询 时 (polymorphic queries) 无 法 生成 
带 UNION 的 SQL 语句 。 


对 于 这 种 映射 策略 而 言 ， 通 常用 &1t;any&gt; 来 实现 到 Payment 的 多 态 关 联 映 
射 。 


<any name="payment" meta-type="string" id-type="long"> 
<meta-value value="CREDIT" class="CreditCardPayment"/> 
<meta-value value="CASH" class="CashPayment"/> 
<meta-value value="CHEQUE" class="ChequePayment"/> 
<column name="PAYMENT_CLASS"/> 
<column name="PAYMENT_ID"/> 

</any> 


9.1.7. 隐 式 多 态 和 其 他 继承 映射 混合 使 用 


这 一 映射 还 有 一 点 需要 注意 。 因 为 每 个 子 类 都 在 各 自 独 立 的 元 
&lt;class&gt; 中 映射 (并 且 Payment 只 是 一 个 接口 )， 每 个 子 类 可 以 很 容易 
的 成 为 另 一 个 继承 体系 中 的 一 部 分 ! (你 仍然 可 以 对 接口 Payment 使 用 多 态 查 
询 。) 


<class name="CreditCardPayment" table="CREDIT_PAYMENT"> 
<id name="id" type="lLong" column="CREDIT_PAYMENT_ID"> 
<generator class="native"/> 
</id> 
<discriminator column="CREDIT_CARD" type="string"/> 
<property name="amount" column="CREDIT_AMOUNT"/> 


<subclass name="MasterCardPayment" discriminator -value="MDC"/> 
<subclass name="VisaPayment" discriminator -value="VISA"/> 
</class> 


<class name="NonelectronicTransaction" table="NONELECTRONIC_TXN"> 
<id name="id" type="long" column="TXN_ID"> 
<generator class="native"/> 
</id> 


<joined-subclass name="CashPayment" table="CASH_PAYMENT"> 
<key column="PAYMENT_ID"/> 
<property name="amount" column="CASH_AMOUNT"/> 


</joined-subclass> 

<joined-subclass name="ChequePayment" table="CHEQUE_PAYMENT"> 
<key column="PAYMENT_ID"/> 
<property name="amount" column="CHEQUE_AMOUNT"/> 


</joined-subclass> 
</class> 


二 "| 


我 们 还 是 没有 明确 的 提 到 Payment 。 如 果 我 们 针对 接口 Payment 执行 查询 
如 from Payment 一 一 Hibernate 自动 返回 CreditCardPayment (和 它 的 子 类 ， 
因为 它们 也 实现 了 接口 Payment )、 cashPayment 和 Chequepayment 的 实 
例 ， 但 不 返回 NonelectronicTransaction 的 实例 。 





9.2. 限制 


对 “每 个 具体 类 映射 一 张 表 ”(table per concrete-class) 的 映射 策略 而 言 ， 隐 式 多 态 
的 方式 有 一 定 的 限制 。 而 &Lt;union-subclass&gt， 了 映射 的 限制 则 没有 那 么 严 


格 。 


下 面 表 格 中 列 出 了 在 Hibernte 中 “每 个 具体 类 一 张 表 "的 策略 和 隐 式 多 态 的 限制 。 


表 9.1. 继承 映射 特性 (Features of inheritance mappings) 


继承 策略 
(Inheritance 多 态 多 对 一 多 太一 对 一 
strategy) 


每 个 类 分 层 
结构 一 张 表 


每 个 子 类 一 &lt;many-to-one&gt; &lt;one-to-one&gt; 
K% i = | ie 


&lt;many-to-oneégt; &lt;one-to-one&gt; 


每 个 具体 类 
一 张 表 
(union- 
subclass) 


每 个 具体 类 
ARER &lt;any&gt; 不 支持 
多 态 ) 


ONN 


&lt;many-to-one&gt; &lt;one-to-one&gt; 


(KVON 


&lt;or 


&lt;or 


&lt;or 
( 仅 对 
于 inve 


情况 ) 


不 支持 


第 10 章 与 对 象 共事 


Hibernate 是 完整 的 对 象 /关系 映射 解决 方案 ， 它 提供 了 对 象 状态 管理 (state 
management) 的 功能 ， 使 开发 者 不 再 需要 理会 底层 数据 库 系统 的 细节 。 也 就 是 
说 ， 相 对 于 常见 的 JDBC/SQL 持 久 层 方案 中 需要 管理 SQL 话 句 ，Hibernate 采 用 了 
更 自然 的 面向 对 象 的 视角 来 持久 化 Java 应 用 中 的 数据 。 


换 名 话说， 使 用 Hibernate 的 开发 者 应 该 总 是 关注 对 象 的 状态 (state)， 不 必 考 虑 SQL 


语句 的 执行 。 这 部 分 细节 已 经 由 Hibernate 掌 管 受 当 ， 只 有 开发 者 在 进行 系统 性 能 


10.1. Hibernate 对 象 状态 (object states) 
10.2. 使 对 象 持 久 化 
10.3. 装载 对 象 
10.4. 查询 
o 10.4.1. 执行 查询 
o 10.4.2. 过 滤 集 合 
o 10.4.3. 条 件 查询 (Criteria queries) 
o 10.4.4. 使 用 原生 SQL 的 查询 
10.5. 修改 持久 对 象 
10.6. 修改 脱 管 (Detached) 对 象 
10.7. 自动 状态 检测 
10.8. 删除 持久 对 象 
10.9. 在 两 个 不 同 数据 库 间 复制 对 象 
10.10. Session 刷 出 (flush) 


10.11. 传播 性 持久 化 (transitive persistence) 


10.12. 使 用 元 数据 


调 优 的 时 候 才 需要 进行 了 解 。 


10.1. Hibernate 对象 状 态 (object states) 


Hibernate 定 义 并 支持 下 列 对 象 状 态 (state): 


Beat (Transient) - 由 new 操作 符 创 建 ， 且 尚未 与 Hibernate Session 关联 的 
对 象 被 认定 为 瞬时 (Transient) 的 。 瞬 时 (Transient) 对 象 不 会 被 持久 化 到 数据 库 
中 ， 也 不 会 被 赋予 持久 化 标识 (identiffen)。 如 果 瞬 时 (Transient) 对 象 在 程序 中 
没有 被 引用 ， 它 会 被 垃圾 回收 器 (garbage collectom) 销 毁 。 使 用 Hibernate 
Session 可 以 将 其 变 为 持久 (Persistent) 状 态 。(Hibernate 会 自动 执行 必要 的 
SQL 语句 ) 


# A (Persistent) - 持久 (Persistent) 的 实例 在 数据 库 中 有 对 应 的 记录 ， 并 拥有 一 
个 持久 化 标识 (identifier)。 持久 (Persistent) 的 实例 可 能 是 刚 被 保存 的 ， 或 刚 被 
加 载 的 ， 无 论 哪 一 种 ， 按 定义 ， 它 存在 于 相关 联 的 Session 作用 范围 内 。 
Hibernate 会 检测 到 处 于 持久 (Persistent) 状 态 的 对 象 的 任何 改动 ， 在 当前 操作 
单元 (unit of work) 执 行 完 毕 时 和 将 对 象 数据 (state) 与 数据 库 同步 (synchronize)。 
开发 者 不 需要 手动 执行 UPDATE 。 将 对 象 从 持久 (Persistent) 状 态 变 成 瞬时 
(Transient) 状 态 同样 也 不 需要 手动 执行 DELETE 语句 。 


Ait‘ (Detached) - 与 持久 (Persistent) 对 象 关联 的 Session 被 关闭 后 ， 对 象 就 
变 为 脱 管 (Detached) 的 。 对 脱 管 (Detached) 对 象 的 引用 依然 有 效 ， 对 象 可 继续 
被 修改 。 脱 管 (Detached) 对 象 如 果 重 新 关联 到 某 个 新 的 Session +, 会 再 次 
转变 为 持久 (Persistent) 的 (在 Detached 其 间 的 改动 将 被 持久 化 到 数据 库 )。 这 个 
功能 使 得 一 种 编程 模型 ， 即 中 间 会 给 用 户 思考 时 间 (user think-time) 的 长 时 间 运 
行 的 操作 单元 (unit of work) 的 编程 模型 成 为 可 能 。 我 们 称 之 为 应 用 程序 事务 ， 
即 从 用 户 观 点 看 是 一 个 操作 单元 (unit of work). 


接 下 来 我 们 来 细致 的 讨论 下 状态 (states) 及 状态 间 的 转换 (state transitions) (以 及 触 
发 状态 转换 的 Hibernate 方 法 ) 。 


10.2. 使 对 象 持久 化 


Hibernate 认 为 持久 化 类 (persistent class) 新 实例 化 的 对 象 是 瞬时 (Transient) 的 。 我 
们 可 通过 将 瞬时 (Transient) 对 象 与 Session 关 联 而 把 它 变 为 持久 (Persistent) 的 。 


DomesticCat fritz = new DomesticCat(); 
fritz.setColor(Color.GINGER); 
fritz.setSex('M'); 

fritz.setName("Fritz"); 

Long generatediId = (Long) sess.save(fritz); 


如 果 cat 的 持久 化 标识 (identifier) 是 generated 类 型 的 ， 那么 该 标识 (identifien) 
会 自动 在 save( ) 被 调用 时 产生 并 分 配给 cat o WR cat 的 持久 化 标识 
(identifier) 是 assigned 类 型 的 ， 或 是 一 个 复合 主键 (composite key)， 那么 该 标识 
(identifien) 应 当 在 调用 save() 之 前 手动 赋予 给 cat o 你 也 可 以 按照 EJB3 early 
draft 中 定义 的 语义 ， 使 用 persist() 替代 save() 。 


此 外 ， 你 可 以 用 一 个 重 载 版 本 的 save() 方法 。 


DomesticCat pk = new DomesticCat(); 
pk.setColor(Color. TABBY) ; 
pk.setSex('F'); 

pk.setName("PK"); 

pk.setKittens( new HashSet() ); 
pk.addkKitten(fritz); 

sess.save( pk, new Long(1234) ); 


如 果 你 持久 化 的 对 象 有 关联 的 对 象 (associated objects) (例如 上 例 中 

的 kittens 集合 ) 那么 对 这 些 对 象 〈 译 注 : pk 和 kittens) 进行 持久 化 的 顺序 是 任 
BY (也 就 是 说 可 以 先 对 kittens 进 行 持久 化 也 可 以 先 对 pk 进行 持久 化 ) ， 除非 你 在 
外 键 列 上 有 NOT NULL 约束 。 Hibernate 不 会 违反 外 键 约束 ， 但 是 如 果 你 用 错误 的 
顺序 持久 化 对 象 (译注 : 在 pk 持久 化 之 前 持久 化 kitten) ， 那 么 可 能 会 违 

R NOT NULL 约束 。 


通常 你 不 会 为 这 些 细节 烦心 ， 因 为 你 很 可 能 会 使 用 Hibernate 的 传播 性 持久 化 
(transitive persistence) 功 能 自动 保存 相关 联 那 些 对 象 。 这 样 连 违反 NOT NULL 的 
束 的 情况 都 不 会 出 现 了 - Hibernate 会 管 好 所 有 的 事情 。 传播 性 持久 化 (transitive 
persistence) 将 在 本 章 稍 后 讨论 。 


10.3. 装载 对 象 


如 果 你 知道 某 个 实例 的 持久 化 标识 (identifier)， 你 就 可 以 使 
用 Session 的 load() 方法 来 获取 它 。 load() 的 另 一 个 参数 是 指定 类 
的 .class 对 象 。 本 方法 会 创建 指定 类 的 持久 化 实例 ， 并 从 数据 库 加 载 其 数据 


(state), 


Cat fritz = (Cat) sess.load(Cat.class, generatedId); 


// you need to wrap primitive identifiers 
long id = 1234; 
DomesticCat pk = (DomesticCat) sess.load( DomesticCat.class, new L¢ 





此 外 , 你 可 以 把 数据 (state) 加 载 到 指定 的 对 象 实例 上 (覆盖 掉 该 实例 原来 的 数据 ) 。 


Cat cat = new DomesticCat(); 

// load pk's state into cat 
sess.load( cat, new Long(pkId) ); 
Set kittens = cat.getKittens(); 


请 注意 如 果 没 有 匹配 的 数据 库 记 录 ， load( ) 方法 可 能 抛 出 无 法 恢复 的 异常 
(unrecoverable exception), 如 果 类 的 映射 使 用 了 代理 (proxy)， load() 方法 会 返 
回 一 个 未 初始 化 的 代理 ， 直 到 你 调用 该 代理 的 某 方法 时 才 会 去 访问 数据 库 。 若 你 希 
望 在 某 对 象 中 创建 一 个 指向 另 一 个 对 象 的 关联 ， 又 不 想 在 从 数据 库 中 装载 该 对 象 时 
同时 装载 相关 联 的 那个 对 象 ， 那 么 这 种 操作 方式 就 用 得 上 的 了 。 如 果 为 相应 类 映射 
关系 设置 了 batch-size ， 那么 使 用 这 种 操作 方式 允许 多 个 对 象 被 一 批 装载 (A 
为 返回 的 是 代理 ， 无 需 从 数据 库 中 抓 取 所 有 对 象 的 数据 ) 。 


如 果 你 不 确定 是 否 有 匹配 的 行 存在 ， 应 该 使 用 get() 方法 ， 它 会 立刻 访问 数据 
库 ， 如 果 没 有 对 应 的 记录 ， 会 返回 null。 


Cat cat = (Cat) sess.get(Cat.class, id); 
if (cat==null) { 

cat = new Cat(); 

sess.save(cat, id); 


return cat; 


你 甚至 可 以 选用 某 个 LockMode ， 用 SQL 的 SELECT ... FOR UPDATE 装载 对 
象 。 请 查阅 API 文 档 以 获取 更 多 信息 。 


Cat cat = (Cat) sess.get(Cat.class, id, LockMode.UPGRADE) ; 


注意 ， 任 何 关 联 的 对 象 或 者 包含 的 集合 都 不 会 被 以 FOR UPDATE 方式 返回 ， 除非 
你 指定 了 lock 或 者 all 作为 关联 (association) 的 级 联 风 格 (cascade style). 


任何 时 候 都 可 以 使 用 refresh() 方法 强迫 装载 对 象 和 它 的 集合 。 如 果 你 使 用 数据 
库 触发 器 功能 来 处 理 对 象 的 某 些 属性 ， 这 个 方法 就 很 有 用 了 。 


sess.save(cat); 
sess.flush(); //force the SQL INSERT 
sess.refresh(cat); //re-read the state (after the trigger executes’ 





此 你 通常 会 出 现 一 个 重要 问题 Hibernate 会 从 数据 库 中 装载 多 少 示 西 ?会 执行 多 少 
条 相应 的 SQL SELECT 语句 ? 这 取决 于 抓 取 策 上 略 (fetching strategy), ABIES 19.1 
节 “ 抓 取 策 略 (Fetching strategies) "中 解释 。 


10.4. 查询 


如 果 不 知道 所 要 寻找 的 对 象 的 持久 化 标识 ， 那 么 你 需要 使 用 查询 。Hibernate 支 持 强 
大 且 易 于 使 用 的 面向 对 象 查询 语言 (HQL)。 如 果 希 望 通过 编程 的 方式 创建 查询 ， 
Hibernate 提 供 了 完善 的 按 条 件 (Query By Criteria, QBC) 以 及 按 样 例 (Query By 
Example, QBE) 进 行 查询 的 功能 。 你 也 可 以 用 原生 SQL(native SQL) 描 述 查询 ， 
Hibernate 额 外 提供 了 将 结果 集 (result set) 转 化 为 对 象 的 支持 。 


10.4.1. 执行 查询 


HQL 和 原生 SQL(native SQL) 查 询 要 通过 为 org.hibernate.Query 的 实例 来 表 
达 。 这 个 接口 提供 了 参数 绑 定 、 结 果 集 义理 以 及 运行 实际 查询 的 方法 。 你 总 是 可 
以 通过 当前 Session 获取 一 个 Query WR: 


List cats = session.createQuery( 
"from Cat as cat where cat.birthdate < ?") 
.setDate(0, date) 
.list(); 


List mothers = session.createQuery( 
"select mother from Cat as cat join cat.mother as mother where 
.setString(0, name) 
SO 入 


List kittens = session.createQuery( 
"from Cat as cat where cat.mother = ?") 
.setEntity(0, pk) 
last); 


Cat mother = (Cat) session.createQuery( 
"select cat.mother from Cat as cat where cat = ?") 
.setEntity(0, izi) 
.uniqueResult(); ]] 


Query motherswithKittens = (Cat) session.createQuery( 
"select mother from Cat as mother left join fetch mother.kitter 
Set uniqueMothers = new HashSet(motherswithKittens.list()); 





一 个 查询 通常 在 调用 list() 时 被 执行 ， 执 行 结果 会 完全 装载 进 内 存 中 的 一 个 集合 
(collection), 查询 返回 的 对 象 人 多 于 持久 (persistent) 状 态 。 如 果 你 知道 的 查询 只 会 返 
回 一 个 对 象 ， 可 使 用 list() 的 快捷 方式 uniqueResult() 。 注意 ， 使 用 集合 预 
先 抓 取 的 查询 往往 会 返回 多 次 根 对 象 (他们 的 集合 类 都 被 初始 化 了 ) 。 你 可 以 通过 
一 个 集合 来 过 滤 这 些 重复 对 象 。 


10.4.1.1. 迭代 式 获 取 结 果 (lterating results) 


某 些 情况 下 ， 你 可 以 使 用 iterate() 方法 得 到 更 好 的 性 能 。 这 通常 是 你 预期 返回 
的 结果 在 session， 或 二 级 缓存 (second-level cache) 中 已 经 存在 时 的 情况 。 如 若 不 
然 ， iterate() 会 比 list() 慢 ， 而 且 可 能 简单 查询 也 需要 进行 多 次 数据 库 访 
问 : iterate() 会 首先 使 用 1 条 语句 得 到 所 有 对 象 的 持久 化 标识 (identifiers)， 再 
根据 持久 化 标识 执行 n 条 附加 的 select 语 句 实 例 化 实际 的 对 象 。 


// fetch ids 
Iterator iter = sess.createQuery("from eg.Qux q order by q.likeline 
while ( iter.hasNext() ) { 
Qux qux = (Qux) iter.next(); // fetch the object 
// something we couldnt express in the query 
if ( qux.calculateComplicatedAlgorithm() ) { 
// delete the current instance 
iter.remove(); 
// dont need to process the rest 
break; 





10.4.1.2. 12/6130 28(tuples)Ay & if 


(译注 : 元 组 (tuples) 指 一 条 结果 行 包 含 多 个 对 象 ) Hibernate 查 询 有 时 返回 元 组 
(tuples)， 每 个 元 组 (tuples) 以 数组 的 形式 返回 : 


Iterator kittensAndMothers = sess.createQuery( 
"select kitten, mother from Cat kitten join kitten.mott 
.list() 
.iterator(); 


while ( kittensAndMothers.hasNext() ) { 
Object[] tuple = (Object[]) kittensAndMothers.next(); 
Cat kitten = tuple[0]; 
Cat mother = tuple[1i]; 


二 = = i 





10.4.1.3. 标量 (Scalar) 结 


查询 可 在 select 从 名 中 指定 类 的 属性 ， 巷 至 可 以 调用 SQL 统 计 (aggregate) 东 
数 。 属性 或 统计 结果 被 认定 为 "标量 (Scalar)" 的 结果 (而 不 是 持久 (persistent state) 
的 实体 ) 。 


Iterator results = sess.createQuery( 
"select cat.color, min(cat.birthdate), count(cat) from Cat 
"group by cat.color") 
.1ist() 
.iterator(); 


while ( results.hasNext() ) { 
Object[] row = (Object[]) results.next(); 
Color type = (Color) row[0]; 
Date oldest = (Date) row[1]; 
Integer count = (Integer) row[2]; 





10.4.1.4. HEBR 


接口 Query 提供 了 对 命名 参数 (named parameters)、JDBC 风 格 的 问号 (?) 参数 
进行 绑 定 的 方法 。 不 同 于 JDBC，Hibernate 对 参数 从 0 开始 计数 。 命名 参数 
(named parameters) 在 查询 字符 串 中 是 形 如 :name 的 标识 符 。 命名 参数 (named 
parameters) 的 优点 是 : 


。 命名 参数 (named parameters) 与 其 在 查询 串 中 出 现 的 顺序 无 关 

。 它们 可 在 同一 查询 串 中 多 次 出 现 

。 它们 本 身 是 自我 说 明 的 

//named parameter (preferred) 

Query q = sess.createQuery("from DomesticCat cat where cat.name = 
q.setString("name", "Fritz"); 


Iterator cats = q.iterate(); 


TE 





//positional parameter 

Query q = sess.createQuery("from DomesticCat cat where cat.name = < 
q.setString(0, "Izi"); 

Iterator cats = q.iterate(); 


E aa 





//named parameter list 

List names = new ArrayList(); 

names.add("Izi"); 

names.add("Fritz"); 

Query q = sess.createQuery("from DomesticCat cat where cat.name in 
q.setParameterList("namesList", names); 

List cats = q.list(); 


IE 





10.4.1.5. 分 页 


如 果 你 需要 指定 结果 集 的 范围 (希望 返回 的 最 大 行 数 /或 开始 的 行 数 ) ， 应 该 使 
用 Query 接口 提供 的 方法 : 


Query q = sess.createQuery("from DomesticCat cat"); 
q.setFirstResult(20); 
q.setMaxResults(10); 
List cats = q.list(); 


Hibernate 知道 如 何 将 这 个 有 限定 条 件 的 查询 转换 成 你 的 数据 库 的 原生 SQL(native 
SQL). 


10.4.1.6. 5 3 a) 4(Scrollable iteration) 


如 果 你 的 JDBC 了 驱动 支持 可 滚动 的 ResuleSet , Query 接口 可 以 使 
用 ScrollableResults ， 人 允许 你 在 查询 结果 中 灵活 游 走 。 


Query q = sess.createQuery("select cat.name, cat from DomesticCat ( 
"order by cat.name"); 

ScrollableResults cats = q.scroll(); 

if ( cats.first() ) { 


// find the first name on each page of an alphabetical list of 
firstNamesOfPages = new ArrayList(); 
do { 
String name = cats.getString(0); 
firstNamesOfPages.add(name); 


} 
while ( cats.scroll(PAGE_SIZE) ); 


// Now get the first page of cats 

pageOfCats = new ArrayList(); 

cats.beforeFirst(); 

int i=0; 

while( ( PAGE SIZE > i++ ) && cats.next() ) pageOfCats.add( cai 


cats.close() 
到 — g 


请 注意 ， 使 用 此 功能 需要 保持 数据 库 连 接 (以 及 游标 (cursor)) 处 于 一 直 打 开 状 
态 。 如 果 你 需要 断 开 连接 使 用 分 页 功能 ， 请 使 
用 setMaxResult() / setFirstResult() 





10.4.1.7. 外 置 命 名 查询 (Externalizing named 
queries) 


你 可 以 在 映射 文件 中 定义 命名 查询 (named queries), 如果 你 的 查询 串 中 包含 可 
能 被 解释 为 XML 标 记 (markup) 的 字符 ， 别 忘 了 用 cDATA GREK, ) 


<query name="ByNameAndMaximumWeight"><! [CDATA[ 
from eg.DomesticCat as cat 
where cat.name = ? 
and cat.weight > ? 
] ]></query> 


参数 绑 定 及 执行 以 编程 方式 (programatically) 完 成 : 


Query q = sess.getNamedQuery("ByNameAndMaximumWeight" ) ; 
q.setString(0, name); 

q.setInt(1, minWeight); 

List cats = q.list(); 


请 注意 实际 的 程序 代码 与 所 用 的 查询 语言 无 关 ， 你 也 可 在 元 数据 中 定义 原生 
SQL(native SQL) 查 询 ， 或 将 原 有 的 其 他 的 查询 语句 放 在 配置 文件 中 ， 这 样 就 可 以 
让 Hibernate 统 一 管理 ， 达 到 迁移 的 目的 。 


也 请 注意 在 &lt;hibernate-mapping&gt; 元 素 中 声明 的 查询 必须 有 一 个 全 局 唯 
一 的 名 字 , 而 在 &1t ;class&gt; 元 素 中 声明 的 查询 自动 具有 全 局 名 ,是 通过 类 的 全 
名 加 以 限定 的 。 比 如 eg.Cat.ByNameAndMaximumWeight 。 


10.4.2. 过 滤 集 合 


合 过 滤器 (filter) 是 一 种 用 于 一 个 持久 化 集合 或 者 数组 的 特殊 的 查询 。 查 询 字符 串 
中 可 以 使 用 "this" 来 引用 集合 中 的 当前 元 素 。 


Collection blackKittens = session.createFilter ( 
pk.getKittens(), 
"where this.color = ?") 
.setParameter( Color.BLACK, Hibernate.custom(ColorUserType.clas 
.list() 
); 


m = 3 
返回 的 集合 可 以 被 认为 是 一 个 包 (bag, 无 顺序 可 重复 的 集合 (collection))， 它 是 所 给 


集合 的 副本 。 原来 的 集合 不 会 被 改动 (这 与 过 滤器 (filter)" 的 隐 含 的 含义 不 符 ， 不 
过 与 我 们 期 待 的 行为 一 致 ) 。 


请 注意 过 滤器 (filter) 并 不 需要 from 子 句 (当然 需要 的 话 它 们 也 可 以 加 上 ) 。 过 滤 
器 (filter) 不 限定 于 只 能 返回 集合 元 素 本 身 。 





Collection blackKittenMates = session.createFilter( 
pk.getKittens(), 
"select this.mate where this.color = eg.Color.BLACK.intValue") 
ISEO 


4 ` = AA 
即使 无 条 件 的 过 滤器 (filter) 也 是 有 意义 的 。 例 如 ， 用 于 加 载 一 个 大 集合 的 子 集 : 
Collection tenkittens = session.createFilter( 
mother.getKittens(), "" 


.setFirstResult(0).setMaxResults(10) 
Last) 


10.4.3. 条 件 查询 (Criteria queries) 


HQL 极 为 强大 ， 但 是 有 些 人 希望 能 够 动态 的 使 用 一 种 面向 对 象 API 创 建 查询 ， 而 非 
在 他 们 的 Java 代 码 中 内 入 字符 串 。 对 于 那 部 分 人 来 说 ，Hibernate 提 供 了 直观 
的 Criteria 查询 APl。 


Criteria crit = session.createCriteria(Cat.class); 
crit.add( Expression.eq( "color", eg.Color.BLACK ) ); 
crit.setMaxResults(10); 

List cats = crit.list(); 


Criteria 以 及 相关 的 样 例 (Example) API 将 会 再 第 15 = R44 j4 (Criteria 
Queries) 中 详细 讨论 。 


10.4.4. 使 用 原生 SQL 的 查询 


你 可 以 使 用 createSQLQuery() 方法 ， 用 SQL 来 描述 查询 ， 并 由 Hibernate 将 结果 
集 转 换 成 对 象 。 请 注意 ， 你 可 以 在 任何 时 候 调 用 session.connection() 来 获得 
并 使 用 JDBC Connection 对 象 。 如 果 你 选择 使 用 Hibernate 的 APl1, 你 必须 把 SQL 


别名 用 大 括号 包围 起 来 : 


List cats = session.createSQLQuery( 
"SELECT {cat.*} FROM CAT {cat} WHERE ROWNUM<10", 
ucatu, 
Cat.class 

).list(); 


List cats = session.createSQLQuery( 
"SELECT {Cat} ID AS {cat.id}, {cat}.SEX AS {cat.sex}, " + 
"f{cat}.MATE AS {cat.mate}, {cat}.SUBCLASS AS {cat.class_ 
"FROM CAT {cat} WHERE ROWNUM<10", 
"cat" F 
Cat.class 
).list() 


EE 


和 Hibernate 查 询 一 样 ，SQL 查 询 也 可 以 包含 命名 参数 和 占 位 参数 。 可 以 在 第 16 章 
Native SQL 查询 找 到 更 多 关于 Hibernate 中 原生 SQL(native SQL) 的 信息 。 





10.5. 修改 持久 对 象 


事务 中 的 持久 实例 (就 是 通过 session 装载 、 人 保存、 创建 或 者 查询 出 的 对 象 ) 被 
应 用 程序 操作 所 造成 的 任何 修改 都 会 在 Session 被 刷 出 (flushed) 的 时 候 被 持久 
化 〈 本 章 后 面 会 详细 讨论 ) 。 这 里 不 需要 调用 某 个 特定 的 方法 (e 

如 update() ， 设 计 它 的 目的 是 不 同 的 ) 将 你 的 修改 持久 化 。 所 以 最 直接 的 更 新 
一 个 对 象 的 方法 就 是 在 Session 处 于 打开 状态 时 load() 它 ， 然 后 直接 修改 即 


可 


DomesticCat cat = (DomesticCat) sess.load( Cat.class, new Long(69) 
cat.setName("PK"); 
sess.flush(); // changes to cat are automatically detected and pet 


SS 


有 时 这 种 程序 模型 效率 低下 ， 因 为 它 在 同一 Session 里 需要 一 条 SQL SELECT 语句 
(用 于 加 载 对 象 ) 以 及 一 条 SQL UPDATE 语句 (持久 化 更 新 的 状态 )。 为 此 
Hibernate 提 供 了 另 一 种 途径 ， 使 用 脱 管 (detached) 实 例 。 


请 注意 Hibernate 本 身 不 提供 直接 执行 UPDATE 或 DELETE 语句 的 APl。 Hibernate 
提供 的 是 _ 状态 管理 (state management) 服 务 ， 你 不 必 考 虑 要 使 用 的 语句 
(statements), JDBC 是 出 色 的 执行 SQL 语句 的 API， 任 何 时 候 调 

用 session.connection() 你 都 可 以 得 到 一 个 JDBC connection 对 象 。 此 外 ， 
在 联机 事务 处 理 (OLTP) 程 序 中 ， 大 量 操 作 (mass operations) 与 对 象 /关系 映射 的 观 
点 是 相 冲 突 的 。 Hibernate 的 将 来 版 本 可 能 会 提供 专门 的 进行 大 量 操作 (mass 
operation) 的 功能 。 参考 第 13 Æ 批量 人 处理 (Batch processing) ， 寻 找 一 些 可 用 的 
批量 (batch) 操 作 技 巧 。 





10.6. 修改 脱 管 (Detached) 对 象 


很 多 程序 需要 在 某 个 事务 中 获取 对 象 ， 然 后 将 对 象 发 送 到 界面 层 去 操作 ， 最 后 在 一 
个 新 的 事务 保存 所 做 的 修改 。 在 高 并 发 访问 的 环境 中 使 用 这 种 方式 ， 通 常 使 用 附带 
版 本 信息 的 数据 来 保证 这 些 “ 长 “工作 单元 之 间 的 隔离 。 


Hibernate 通 过 提供 Session.update() 或 Session.merge() 重新 关联 脱 管 实例 
的 办 法 来 支持 这 种 模型 。 


// in the first session 

Cat cat = (Cat) firstSession.load(Cat.class, catId); 
Cat potentialMate = new Cat(); 
firstSession.save(potentialMate) ; 


// in a higher layer of the application 
cat.setMate(potentialMate) ; 


// later, in a new session 
secondSession.update(cat); // update cat 
secondSession.update(mate); // update mate 


如 果 具 有 catId 持久 化 标识 的 Cat 之 前 已 经 
被 另 一 Session(secondSession) 装载 了 ， 应 用 程序 进行 重 关 联 操作 (reattach) 的 
时 候 会 抛 出 一 个 异常 。 


如 果 你 确定 当前 session 没 有 包含 与 之 具有 相同 持久 化 标识 的 持久 实例 ， 使 

用 update() 。 如 果 想 随时 合并 你 的 的 改动 而 不 考虑 session 的 状态 ， 使 

用 merge() > 换 句 话说 ， 在 一 个 新 Session 中 通常 第 一 个 调用 的 是 update() A 
法 ， 以 便 保证 重新 关联 脱 管 (detached) 对 象 的 操作 首先 被 执行 。 


如 果 希 望 相关 联 的 脱 管 对 象 (通过 引用 “可 到 达 " 的 脱 管 对 象 ) 的 数据 也 要 更 新 到 数 
据 库 时 (并 且 也 仅仅 在 这 种 情况 ) ， 可 以 对 该 相关 联 的 脱 管 对 象 单独 调 

用 update() 当然 这 些 可 以 自动 完成 ， 即 通过 使 用 传播 性 持久 化 (transitive 
persistence)， 请 看 第 10.11 节 “ 传 播 性 持久 化 (transitive persistence)’. 


lock() 方法 也 允许 程序 重新 关联 某 个 对 象 到 一 个 新 session 上 。 不 过 ， 该 脱 管 
(detached) 的 对 象 必 须 是 没有 修改 过 的 ! 


//just reassociate: 

sess.lock(fritz, LockMode.NONE); 

//do a version check, then reassociate: 

sess.lock(izi, LockMode.READ); 

//do a version check, using SELECT ... FOR UPDATE, then reassociate 
sess.lock(pk, LockMode.UPGRADE) ; 








请 注意 ， lock() 可 以 搭配 多 种 LockMode ， 更 多 信息 请 阅读 API 文 档 以 及 关于 
事务 义理 (transaction handling) 的 章节 。 重 新 关联 不 是 lock() 的 唯一 用 途 。 


其 他 用 于 长 时 间 工 作 单元 的 模型 会 在 第 11.3 节 “ 乐 观 并 发 控制 (Optimistic 
concurrency control)" 中 讨论 。 


10.7. 自动 状态 检测 


Hibernate 的 用 户 便 要 求 一 个 既 可 自动 分 配 新 持久 化 标识 (identifier) 保 存 瞬 时 
(transient) 对 象 ， 又 可 更 新 /重新 关联 脱 管 (detached) 实 例 的 通用 方法 。 
saveOrUpdate() 方法 实现 了 这 个 功能 。 


// in the first session 

Cat cat = (Cat) firstSession.load(Cat.class, catID); 
// in a higher tier of the application 

Cat mate = new Cat(); 

cat.setMate(mate); 

// later, in a new session 


secondSession.saveOrUpdate(cat); // update existing state (cat hi 
secondSession.saveOrUpdate(mate); // save the new instance (mate 1 


| O B 


saveOrUpdate() 用 途 和 话 义 可 能 会 使 新 用 户 感到 迷惑 。 首先 ， 只 要 你 没有 尝试 
在 某 个 session 中 使 用 来 自 另 一 session 的 实例 ， 你 就 应 该 不 需要 使 用 update() ， 
saveOrUpdate() ， 或 merge() 。 有 些 程序 从 来 不 用 这 些 方法 。 


通常 下 面 的 场景 会 使 用 update() 或 saveOrupdate( ) 
。 程序 在 第 一 个 session 中 加 载 对 象 
。 该 对 象 被 传递 到 表现 层 
o 对 象 发 生 了 一 些 改 动 
o 该 对 象 被 返回 到 业务 逻辑 层 
。 程序 调用 第 二 个 session 的 update() 方法 持久 这 些 改动 
saveOrUpdate() 做 下 面 的 事 : 
e 如果 对 象 已 经 在 本 session 中 持久 化 了 ， 不 做 任何 事 
e 如 果 另 一 个 与 本 session 关 联 的 对 象 拥有 相同 的 持久 化 标识 (identiffem)， 抛 出 一 
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e。 如 果 对 象 没有 持久 化 标识 (identifier) 属 性 ， 对 其 调用 save() 


e。 如 果 对 象 的 持久 标识 (identifier) 表 明 其 是 一 个 新 实例 化 的 对 象 ， 
用 save() 


如 果 对 象 是 附带 版 本 信息 的 〈 通 
过 &lt;version&gt; 或 &lt;timestamp&gt; ) 并 且 版 本 属性 的 值 表明 其 
是 一 个 新 实例 化 的 对 象 ， save() Go 


e 否则 update() 这 个 对 象 
merge() 可 非常 不 同 : 


e 如 果 session 中 存在 相同 持久 化 标识 (identifier) 的 实例 ， 用 用 户 给 出 的 对 象 的 状 
态 履 盖 旧 有 的 持久 实例 


如 果 session 没 有 相应 的 持久 实例 ， 则 尝试 从 数据 库 中 加 载 ， 或 创建 新 的 持久 化 
实例 


。 最 后 返回 该 持久 实例 
eo 用 户 给 出 的 这 个 对 象 没有 被 关联 a 到 session 上 ， 它 依旧 是 脱 管 的 


10.8. 删除 持久 对 象 


使 用 Session.delete() 会 把 对 象 的 状态 从 数据 库 中 移 除 。 当然 ， 你 的 应 用 程序 
可 能 仍然 持 有 一 个 指向 已 删除 对 象 的 引用 。 所 以 ， 最 好 这 样 理解 : delete() 的 用 
途 是 把 一 个 持久 实例 变 成 瞬时 (transient) 实 例 。 


sess.delete(cat); 


你 可 以 用 你 喜欢 的 任何 顺序 删除 对 象 ， 不 用 担心 外 键 约束 冲突 。 当 然 ， 如 果 你 搞 错 
了 顺序 ， 还 是 有 可 能 引发 在 外 键 字段 定义 的 NOT NULL 约束 冲突 。 例如 你 删除 了 
父 对 象 ， 但 是 忘记 删除 孩子 们 。 


10.9. 在 两 个 不 同 数据 库 间 复制 对 象 


偶尔 会 用 到 不 重新 生成 持久 化 标识 (identifier)， 将 持久 实例 以 及 其 关联 的 实例 持久 
到 不 同 的 数据 库 中 的 操作 。 


//retrieve a cat from one database 

Session sessioni = factory1.openSession(); 
Transaction tx1 = sessioni.beginTransaction(); 
Cat cat = sessioni.get(Cat.class, catId); 
tx1.commit(); 

sessioni1.close(); 


//reconcile with a second database 

Session session2 = factory2.openSession(); 

Transaction tx2 = session2.beginTransaction(); 
session2.replicate(cat, ReplicationMode.LATEST_VERSION) ; 
tx2.commit(); 

session2.close(); 


ReplicationMode 决定 在 和 数据 库 中 已 存在 记录 由 冲突 时 ， replicate() 如 何 
义理 。 


e ReplicationMode. IGNORE -忽略 它 
e ReplicationMode.OVERWRITE - 覆盖 相同 的 行 
e ReplicationMode.EXCEPTION - 抛 出 异常 


e ReplicationMode.LATEST_VERSION - 如 果 当 前 的 版 本 较 新 ， 则 履 盖 ， 否 则 
忽略 


这 个 功能 的 用 途 包 括 使 录入 的 数据 在 不 同 数据 库 中 一 致 ， 产 品 升 级 时 升级 系统 配置 
信息 ， 回 滚 non-ACID 事 务 中 的 修改 等 等 。 (译注 ，non-ACID， 非 ACID;ACID， 
Atomic, Consistent, Isolated and Durable 的 缩写 ) 


10.10. Session 刷 出 (flush) 
每 间隔 一 段 时 间 ， Session 会 执行 一 些 必 需 的 SQL 语句 来 把 内 存 中 的 对 象 的 状态 
同步 到 JDBC 连 接 中 。 这 个 过 程 被 称 为 刷 出 (flush)， 默 认 会 在 下 面 的 时 间 点 执行 : 
o 在 某 些 查询 执行 之 前 
e 在 调用 org.hibernate.Transaction.commit() 的 时 候 
e 在 调用 Session.flush() 的 时 候 
涉及 的 SQL 语句 会 按照 下 面 的 顺序 发 出 执行 : 
1. 所 有 对 实体 进行 插入 的 语句 ， 其 顺序 按照 对 象 执 行 Session.save() 的 时 间 
顺序 
. 所 有 对 实体 进行 更 新 的 语句 
. 所 有 进行 集合 删除 的 语句 
.所 有 对 集合 元 素 进行 删除 ， 更 新 或 者 插入 的 语句 
. 所 有 进行 集合 插入 的 语句 
. 所 有 对 实体 进行 删除 的 语句 ， 其 顺序 按照 对 象 执 行 Session.delete() 的 时 
间 顺 序 


(有 一 个 例外 是 ， 如 果 对 象 使 用 native 方式 来 生成 ID (持久 化 标识 ) 的 话 ， 它 们 
一 执行 save 就 会 被 插入 。) 


除非 你 明确 地 发 出 了 flush() 指令 ， 关 于 Session 何 时 会 执行 这 些 JDBC 调 用 是 完 
全 无 法 保证 的 ， 只 能 保证 它们 执行 的 前 后 顺序 。 当然 ，Hibernate 保 
jE, Query.list(..) 绝对 不 会 返回 已 经 失效 的 数据 ， 也 不 会 返回 错误 数据 。 


也 可 以 改变 默认 的 设置 ， 来 让 刷 出 (flush) 操 作 发 生 的 不 那么 频繁 。 FlushMode 类 
定义 了 三 种 不 同 的 方式 。 仅 在 提交 时 刷 出 ( 仅 当 Hibernate 的 Transaction API 被 
使 用 时 有 效 )， 按照 刚才 说 的 方式 刷 出 ， 以 及 除非 明确 使 用 flush() 否则 从 不 刷 
出 。 最 后 一 种 模式 对 于 那些 需要 长 时 间 保 持 Session 为 打开 或 者 断 线 状态 的 长 时 
间 运 行 的 工作 单元 很 有 用 。 (参见 第 11.3.2 节 “扩展 周期 的 session 和 自动 版 本 化 ”). 
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sess = sf.openSession(); 
Transaction tx = sess.beginTransaction(); 
sess.setFlushMode(FlushMode.COMMIT); // allow queries to return sté 


Cat izi = (Cat) sess.load(Cat.class, id); 
1izi.setName(iznizi); 


// might return stale data 
sess.find("from Cat as cat left outer join cat.kittens kitten"); 


// change to izi is not flushed! 


tx.commit(); // flush occurs 
sess.close(); 


图 aE 


刷 出 (flush) 期 间 ， 可 能 会 抛 出 异常 。 (例如 一 个 DML 操 作 违 反 了 约束 ) 异常 处 理 涉 
及 到 对 Hibernate 事 务 性 行为 的 理解 ， 因 此 我 们 将 在 第 11 章 事务 和 并 发 中 讨论 。 





10.11. 传播 性 持久 化 (transitive persistence) 


对 每 一 个 对 象 都 要 执行 保存 ， 人 删除 或 重 关 联 操 作 让 人 感觉 有 点 麻烦 ， 尤 其 是 在 处 理 
许多 彼此 关联 的 对 象 的 时 候 。 一 个 常见 的 例子 是 父子 关系 。 考 虑 下 面 的 例子 : 


如 果 一 个 父子 关系 中 的 子 对 象 是 值 类 型 (value typed) 〈 例 如， 地 址 或 字符 串 的 集 
A) 的 ， 他 们 的 生命 周期 会 依赖 于 父 对 象 ， 可 以 享受 方便 的 级 联 操作 (Cascading)， 
不 需要 额外 的 动作 。 父 对 象 被 保存 时 ， 这 些 值 类 型 (value typed) 子 对 象 也 将 被 保 
存 ; 父 对 象 被 删除 时 ， 子 对 象 也 将 被 删除 。 这 对 将 一 个 子 对 象 从 集合 中 移 除 是 同 祥 
Ax : Hibernate 会 检测 到 ， 并 且 因 为 值 类 型 (value typed) 的 对 象 不 可 能 被 其 他 对 象 
引用 ， 所 以 Hibernate 会 在 数据 库 中 删除 这 个 子 对 象 。 


现在 者 虑 同样 的 场景 ， 不 过 父子 对 象 都 是 实体 (entities) 类 型 ， 而 非 值 类 型 (value 
typed)( 例 如， 类 别 与 个 体 ， 或 母 猫 和 小 猫 ) 。 实体 有 自己 的 生命 期 ， 人 允许 共享 对 
其 的 引用 (因此 从 集合 中 移 除 一 个 实体 ， 不 意味 着 它 可 以 被 删除 ) ， 并 且 实 体 到 其 
他 关联 实体 之 间 默 认 没 有 级 联 操作 的 设置 。 Hibernate 默 认 不 实现 所 谓 的 可 到 达 即 
持久 化 (persistence by reachability) 的 策略 。 


每 个 Hibernate session 的 基本 操作 - 包括 

persist(), merge(), saveOrUpdate(), delete(), lock(), refresh(), ev: 
- 都 有 对 应 的 级 联 风格 (cascade style), 这 些 级 联 风格 (cascade style) 风 格 分 别 命名 
为 

create, merge, save-update, delete, lock, refresh, evict, replicate 
o 如 果 你 希望 一 个 操作 被 顺 着 关联 关系 级 联 传播 ， 你 必须 在 映射 文件 中 指出 这 一 
点 。 例 如 : 


<one-to-one name="person" cascade="persist"/> 


级 联 风格 (cascade style) 是 可 组 合 的 : 


<one-to-one name="person" cascade="persist, delete, lock"/> 
1 了 


你 可 以 使 用 cascade="all" 来 指定 全 部 操作 都 顺 着 关联 关系 级 联 (cascaded)。 $Å 
认 值 是 cascade="none" ， 即 任何 操作 都 不 会 被 级 联 (cascaded)。 


注意 有 一 个 特殊 的 级 联 风格 (cascade style) delete-orphan ， 只 应 用 于 one-to- 
many 关 联 ， 表 明 delete() 操作 应 该 被 应 用 于 所 有 从 关联 中 删除 的 对 象 。 
建议 : 


e 通常 在 &lt;many-to-one&gt; 或 &lt;many-to-many&gt; 关系 中 应 用 级 联 
(cascade) 没 什么 意义 。 级 联 (cascade) 通 常 在 
&lt;one-to-one&gt; 和 &lt;one-to-many&gt; 关系 中 比较 有 用 。 


e。 如 果子 对 象 的 寿命 限定 在 父亲 对 象 的 寿命 之 内 ， 可 通过 指 
定 cascade="all,delete-orphan" 将 其 变 为 自动 生命 周期 管理 的 对 象 
(lifecycle object). 


。 其 他 情况 ， 你 可 根本 不 需要 级 联 (cascade)。 但 是 如 果 你 认为 你 会 经 常 在 某 个 事 
务 中 同时 用 到 父 对 象 与 子 对 象 ， 并 且 你 希望 少 打点 儿 字 ， 可 以 考虑 使 


用 cascade="persist,merge,save-update" 。 


可 以 使 用 cascade="all" 将 一 个 关联 关系 (无 论 是 对 值 对 象 的 关联 ， 或 者 对 一 个 
集合 的 关联 ) 标记 为 父 / 子 关系 的 关联 。 这 样 对 父 对 象 进行 save/update/delete 操 作 
就 会 导致 子 对 象 也 进行 save/update/delete 操 作 。 


此 外 ， 一 个 持久 的 父 对 象 对 子 对 象 的 浅 引 用 (mere reference) 会 导致 子 对 象 被 同步 

save/update。 不 过 ， 这 个 隐喻 (metaphon) 的 说 法 并 不 完整 。 除非 关联 

是 &lt;one-to-many&gt; 关联 并 且 被 标记 为 cascade="delete-orphan" ， 否 
则 父 对 象 失 去 对 某 个 子 对 象 的 引用 不 会 导致 该 子 对 象 被 自动 删除 。 父子 关系 的 级 联 
(cascading) 操 作 准 确 语义 如 下 : 


e 如果 父 对 象 被 persist() ， 那 么 所 有 子 对 象 也 会 被 persist() 
o 如果 父 对 象 被 merge() ， 那 么 所 有 子 对 象 也 会 被 merge() 


eo 如 果 父 对 象 被 save() ， update() 或 saveOrUpdate() ， 那 么 所 有 子 对 
象 则 会 被 saveorUpdate() 


如 果 某 个 持久 的 父 对 象 引 用 了 瞬时 (transient) 或 者 脱 管 (detached) 的 子 对 象 ， 那 
么 子 对 象 将 会 被 saveOrupdate() 


如 果 父 对 象 被 删除 ， 那 么 所 有 子 对 象 也 会 被 delete() 


除非 被 标记 为 cascade="delete-orphan" 【删除 “孤儿 ”模式 ， 此 时 不 被 任何 
一 个 父 对 象 引用 的 子 对 象 会 被 删除 ) ， 否则 子 对 象 失掉 父 对 象 对 其 的 引用 时 ， 
什么 事 也 不 会 发 生 。 如 果 有 特殊 需要 ， 应 用 程序 可 通过 显 式 调 用 delete() 删 除 
子 对 象 。 


最 后 ， 注 意 操作 的 级 联 可 能 是 在 调用 期 (call time) KAS AHA (flush time) 作 用 到 对 象 
图 上 的 。 所 有 的 操作 ， 如 果 人 允许 ， 都 在 操作 被 执行 的 时 候 级 联 到 可 触及 的 关联 实体 
上 。 然 而 ， save-upate 和 delete-orphan 是 在 Session flush 的 时 候 才 作用 
到 所 有 可 触及 的 被 关联 对 象 上 的 。 


10.12. 使 用 元 数据 


Hibernate 中 有 一 个 非常 丰富 的 元 级 别 (meta-level) 的 模型 ， 含 有 所 有 的 实体 和 值 类 
型 数据 的 元 数据 。 有 时 这 个 模型 对 应 用 程序 本 身 也 会 非常 有 用 。 比如 说 ， 应 用 程 
序 可 能 在 实现 一 种 “智能 ”的 深度 拷贝 算法 时 ， 通过 使 用 Hibernate 的 元 数据 来 了 解 哪 
些 对 象 应 该 被 拷贝 〈 比 如 ， 可 变 的 值 类 型 数据 ) ， 那些 不 应 该 〈 不 可 变 的 值 类 型 数 
据 ， 也 许 还 有 某 些 被 关联 的 实体 ) 。 


Hibernate 提 供 了 ClassMetadata 接口 ， CollectionMetadata 接口 和 Type 层 
次 体系 来 访问 元 数据 。 可 以 通过 SessionFactory 获取 元 数据 接口 的 实例 。 


Cata mritz i= ee 2 
ClassMetadata catMeta = sessionfactory.getClassMetadata(Cat.class) , 


Object[] propertyValues = catMeta.getPropertyValues(fritz); 
String[] propertyNames = catMeta.getPropertyNames(); 
Type[] propertyTypes = catMeta.getPropertyTypes(); 


// get a Map of all properties which are not collections or associé 
Map namedValues = new HashMap(); 
for ( int i=0; i<propertyNames.length; i++ ) { 
if ( !propertyTypes[i].isEntityType() && !propertyTypes[i].isCc¢ 
namedValues.put( propertyNames[i], propertyValues[i] ); 
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Hibernate 的 事务 和 并 发 控制 很 容易 掌握 。Hibernate 直 接 使 用 JDBC 连 接 和 JTA 资 
源 ， 不 添加 任何 附加 锁定 行为 。 我 们 强烈 推荐 你 花 点 时 间 了 解 JDBC 编 程 ，ANSI 
SQL 查询 语言 和 你 使 用 的 数据 库 系 统 的 事务 隅 离 规范 。 


Hibernate 不 锁定 内 存 中 的 对 象 。 你 的 应 用 程序 会 按照 你 的 数据 库 事务 的 隔离 级 别 规 
定 的 那样 运作 。 幸 亏 有 了 Session ， 使 得 Hibernate 通 过 标识 符 查 找 ， 和 实体 查询 
(不 是 返回 标量 值 的 报表 查询 ) 提供 了 可 重复 的 读 取 (Repeatable reads) 功 

fe, Session 同时 也 是 事务 范围 内 的 缓存 (cache) 。 


除了 对 自动 乐观 并 发 控制 提供 版 本 管理 ， 针 对 行 级 翡 观 锁定 ，Hibernate 也 提供 了 畏 
BOA) 〈 较 小 的 )API， 它 使 用 了 SELECT FOR UPDATE 的 SQL 语法 。 本 章 后 面 会 讨论 
乐观 并 发 控制 和 这 个 API。 


我 们 从 Configuration Æ, SessionFactory 层 , 和 Session 层 开始 讨论 
Hibernate 的 并 行 控 制 、 数 据 库 事务 和 应 用 程序 的 长 事务 。 


11.1. Session] 456 A (transaction scope) 


SessionFactory 对 象 的 创建 代价 很 昂贵 ， 它 是 线程 安全 的 对 象 ， 它 为 所 有 的 应 
用 程序 线程 所 共享 。 它 只 创建 一 次 ， 通 常 是 在 应 用 程序 启动 的 时 候 ， 由 一 
个 configuraion 的 实例 来 创建 。 


Session 对 象 的 创建 代价 比较 小 ， 是 非 线 程 安全 的 ， 对 于 单个 请 求 ， 单 个 会 话 、 
单个 的 工作 单元 而 言 ， 它 只 被 使 用 一 次 ， 然 后 就 丢弃 。 只 有 在 需要 的 时 候 ， 一 

个 Session 对 象 才 会 获取 一 个 JDBC 的 Connection (或 一 个 Datasource ) 
对 象 ， 因 此 假若 不 使 用 的 时 候 它 不 消费 任何 资源 。 


此 外 我 们 还 要 考虑 数据 库 事务 。 数 据 库 事 务 应 该 尽 可 能 的 短 ， 降 低 数据 库 中 的 锁 争 
用 。 数据 库 长 事务 会 阻止 你 的 应 用 程序 扩展 到 高 的 并 发 负载 。 因 此 ， 假 若 在 用 户 思 
考 期 间 让 数据 库 事 务 开 着 ， 直 到 整个 工作 单元 完成 才 关 闭 这 个 事务 ， 这 绝 不 是 一 个 
好 的 设计 。 

一 个 操作 单元 (Unit of work) 的 范围 是 多 大 ? 单个 的 Hibernate session 能 跨越 多 个 
数据 库 事 务 吗 ?还 是 一 个 Session 的 作用 范围 对 应 一 个 数据 库 事 务 的 范围 ? 应 该 
何 时 打开 Session ， 何 时 关闭 Session ?3， 你 又 如 何 划 分 数据 库 事务 的 边界 
呢 ? 


11.1.1. 操作 单元 (Unit of work) 


首先 ， 别 用 session-peroperation 这 种 反 模 式 了 ， 也 就 是 说 ， 在 单个 线程 中 ， 不 要 
因为 一 次 简单 的 数据 库 调 用 ， 就 打开 和 关闭 一 次 Session ! 数据 库 事务 也 是 如 
此 。 应 用 程序 中 的 数据 库 调 用 是 按照 计划 好 的 次 序 ， 分 组 为 原子 的 操作 单元 。 ( 注 
意 ， 这 也 意味 着 ， 应 用 程 序 中 ， 在 单个 的 SQL 语句 发 送 之 后 ， 自 动 事务 提交 (auto- 
commit) 模 式 失 效 了 。 这 种 模式 专门 为 SQL 控 制 台 操作 设计 的 。 Hibernate 禁 止 立 即 
自动 事务 提交 模式 ， 或 者 期 望 应 用 服务 器 禁止 立即 自动 事务 提交 模式 。) 数据 库 事 
务 绝 不 是 可 有 可 无 的 ， 任 何 与 数据 库 之 间 的 通讯 都 必须 在 某 个 事务 中 进行 ， 不 管 你 
是 在 读 还 是 在 写 数 据 。 对 读数 据 而 言 ， 应 该 避免 auto-commit 行 为 ， 因 为 很 多 小 的 
事务 比 一 个 清晰 定义 的 工作 单元 性 能 差 。 后 者 也 更 容易 维护 和 扩展 。 


在 多 用 户 的 client/server 应 用 程序 中 ， 最 常用 的 模式 是 每 个 请 求 一 个 会 话 (session- 
per-request) 在 这 种 模式 下 ， 来 自 客户 端的 请 求 被 发 送 到 服务 器 端 〈 即 Hibernate 
持久 化 层 运 行 的 地 方 ) ， 一 个 新 的 Hibernate Session 被 打开 ， 并 且 执 行 这 个 操 
作 单 元 中 所 有 的 数据 库 操 作 。 一 旦 操作 完成 (同时 对 客户 端的 响应 也 准备 就 绪 ) ， 
session 被 同步 ， 然 后 关闭 。 你 也 可 以 使 用 单 个 数据 库 事务 来 处 理 客户 端 请 求 ， 在 
你 打开 Session 之 后 启动 事务 ， 在 你 关闭 Session 之 前 提交 事务 。 会 话 和 请 求 
之 间 的 关系 是 一 对 一 的 关系 ， 这 种 模式 对 于 大 多 数 应 用 程序 来 说 是 很 棒 的 。 


实现 才 是 真正 的 挑战 。Hibernate 内 置 了 对 "当前 session(current session)" 的 管理 ， 
用 于 简化 此 模式 。 你 要 做 的 一 切 就 是 在 服务 器 妆 要 处 理 请 求 的 时 候 ， 开 局 事务， 在 
响应 发 送 给 客户 之 前 结束 事务 。 你 可 以 用 任何 方式 来 完成 这 一 操作 ， 通 常 的 方案 
有 ServletFilter ， 在 service 方 法 中 进行 pointcut 的 AOP 拦 截 器 ， 或 者 
proxy/interception 容 器 。EJB 容 器 是 实现 横 切 诸如 EJB session bean 上 的 事务 分 
界 ， 用 CMT 对 事务 进行 声明 等 方面 的 标准 手段 。 假 若 你 决定 使 用 编程 式 的 事务 分 
界 ， 请 参考 本 章 后 面 讲 到 的 Hibernate Transaction API， 这 对 易 用 性 和 代码 可 
移植 性 都 有 好 处。 


在 任何 时 间 ， 任 何 地 方 ， 你 的 应 用 代码 可 以 通过 简单 的 调 

用 sessionFactory.getCurrentSession() 来 访问 "当前 session"， 用 于 义理 请 
求 。 你 总 是 会 得 到 当前 数据 库 事务 范围 内 的 Session 。 在 使 用 本 地 资源 或 JTA 环 
境 时 ， 必 须 配 置 它 ， 请 参见 第 2.5 节 “ 上 下 文 相 关 的 (Contextual) Session”, 


Auat, Session 和 数据 库 事 务 的 边界 延伸 到 "展示 层 被 泻 染 后 "会 带 来 便利 。 有 
些 serlvet 应 用 程序 在 对 请 求 进行 处 理 后 ， 有 个 单独 的 泻 染 期 ， 这 种 延伸 对 这 种 程序 
特别 有 用 。 假 若 你 实现 你 自己 的 拦截 器 ， 把 事务 边界 延伸 到 展示 层 泻 染 结束 后 非常 
容易 。 然 而 ， 假 若 你 依赖 有 容器 管理 事务 的 EJB， 这 就 不 太 容易 了 ， 因 为 事务 会 在 
EJB 方 法 返回 后 结束 ， 而 那 是 在 任何 展示 层 泻 染 开始 之 前 。 请 访问 Hibernate 网 站 和 
论坛 ， 你 可 以 找到 Open Session in Vew 这 一 模式 的 提示 和 示例 。 


11.1.2. Kxtié 


session-per-request 模 式 不 仅仅 是 一 个 可 以 用 来 设计 操作 单元 的 有 用 概念 。 很 多 业 

务 处 理 都 需 要 一 系列 完整 的 与 用 户 之 间 的 交互 ， 而 这 些 用 户 是 指 对 数据 库 有 交叉 访 
问 的 用 户 。 在 基于 web 的 点 用 和 企业 点 用 中 ， 跨 用 户 交互 的 数据 库 事务 是 无 法 接受 
的 。 考 虑 下 面 的 例子 : 


。 在 界面 的 第 一 屏 ， 打 开 对 话 框 ， 用 户 所 看 到 的 数据 是 被 一 个 特定 的 ”Session 
和 数据 库 事 务 载 和 人 (load) 的 。 用 户 可 以 随意 修改 对 话 框 中 的 数据 对 象 。 


。 5 分 钟 后 ， 用 户 点 击 “ 保 存 "， 期 望 所 做 出 的 修改 被 持久 化 ; 同时 他 也 期 望 自己 是 
唯一 修改 这 个 信息 的 人 ， 不 会 出 现 修改 冲突 。 


从 用 户 的 角度 来 看 ， 我 们 把 这 个 操作 单元 称 为 长 时 间 运 行 的 对 话 (conversation) ， 
或 者 (or 应 用 事务 ,application transaction)。 在 你 的 应 用 程序 中 ， 可 以 有 很 多 种 方法 
来 实现 它 。 


头 一 个 幼稚 的 做 法 是 ， 在 用 户 思 考 的 过 程 中 ， 保 持 Session 和 数据 库 事 务 是 打开 
的 ， 保持 数据 库 锁 定 ， 以 阻止 并 发 修改 ， 从 而 保证 数据 库 事务 隔离 级 别 和 原子 操 
Me 这 种 方式 当然 是 一 个 反 模 式 ， 因为 锁 争 用 会 导致 占用 程序 无 法 扩展 并 发 用 户 的 
类 目 。 


很 明显 ， 我 们 必须 使 用 多 个 数据 库 事务 来 实现 这 个 对 话 。 在 这 个 例子 中 ， 维 护 业务 
处 理 的 事务 隔离 变 成 了 应用 程序 层 的 部 分 责任 。 一 个 对 话 通 常 跨越 多 个 数据 库 事 
务 。 如 果 仅 仅 只 有 一 个 数据 库 事 务 (最 后 的 那个 事务 ) 保存 更 新 过 的 数据 ， 而 所 有 
其 他 事务 只 是 单纯 的 读 取 数据 (例如 在 一 个 跨越 多 个 请 求 /响应 周期 的 向 导 风 格 的 
对 话 框 中 ) ， 那 么 应 用 程序 事务 将 保证 其 原子 性 。 这 种 方式 比 听 起 来 还 要 容易 实 
现 ， 特 别 是 当 你 使 用 了 Hibernate 的 下 述 特性 的 时 候 : 


e 自动 版 本 化 - Hibernate 能 够 自动 进行 乐观 并 发 控制 ， 如 果 在 用 户 思考 的 过 程 
中 发 生 并 发 修改 ，Hibernate 能 够 自动 检测 到 。 一 般 我 们 只 在 对 话 结束 时 才 检 
查 。 


脱 管 对 象 (Detached Objects) - 如 果 你 决定 采用 前 面 已 经 讨论 过 的 session- 
per-request 模 式 ， 所 有 载 入 的 实例 在 用 户 思考 的 过 程 中 都 处 于 与 Session 脱 离 
的 状态 。Hibernate 人 允许 你 把 与 Session 脱 离 的 对 象 重 新 关联 到 Session 上 ， 并 
且 对 修改 进行 持久 化 ， 这 种 模式 被 称 为 session-per-request-with-detached- 
objects。 自 动 版 本 化 被 用 来 隔离 并 发 修改 。 


Extended (or Long) Session - Hibernate 的 Session 可 以 在 数据 库 事 务 提交 
之 后 和 底层 的 JDBC 连 接 断 开 ， 当 一 个 新 的 客户 端 请 求 到 来 的 时 候 ， 它 又 重新 
连接 上 底层 的 JDBC 连 接 。 这 种 模式 被 称 之 为 session-per-conversation， 这 种 
情况 可 能 会 造成 不 必要 的 Session 和 JDBC 连 接 的 重新 关联 。 自 动 版 本 化 被 用 
来 隔离 并 发 修改 ，Session 通常 不 允许 自动 flush, 而 是 明确 flush。 


session-per-request-with-detached-objects 和 session-per-conversation 各 有 优 缺 
点 ， 我 们 在 本 章 后 面 乐 观 并 发 控制 那 部 分 再 进行 讨论 。 


11.1.3. 关注 对 象 标 识 (Considering object 
identity) 


应 用 程序 可 能 在 两 个 不 同 的 Session 中 并 发 访问 同一 持久 化 状态 ， 但 是 ， 一 个 持 
久 化 类 的 实例 无 法 在 两 个 Session 中 共享 。 因 此 有 两 种 不 同 的 标识 语义 : 


数据 库 标识 

foo.getId().equals( bar.getId() ) 
JVM 标识 

foo==bar 


对 于 那些 关联 到 特定 Session (也 就 是 在 单个 Session 的 范围 内 ) 上 的 对 象 来 
说 ， 这 两 种 标识 的 语义 是 等 价 的 ， 与 数据 库 标 识 对 应 的 JVM 标 识 是 由 Hibernate 来 

保证 的 。 不 过 ， 当 应 用 程序 在 两 个 不 同 的 Session 中 并 发 访问 具有 同一 持久 化 标 识 
的 业务 对 象 实例 的 时 候 ， 这 个 业务 对 象 的 两 个 实例 事实 上 是 不 相同 的 〈 从 JVM 识 别 
。 这 种 冲突 可 以 通过 在 同步 和 提交 的 时 候 使 用 自动 版 本 化 和 乐 观 锁定 方法 来 
BR, 

这 种 方式 把 关于 并 发 的 头疼 问题 留 给 了 Hibernate 和 数据 库 ; 由 于 在 单个 线程 内 ， 操 
作 单 元 中 的 对 象 识 别 不 需要 代价 昂贵 的 锁定 或 其 他 意义 上 的 同步 ， 因 此 它 同 时 可 以 
提供 最 好 的 可 伸缩 性 。 只 要 在 单个 线程 只 持 有 一 个 _ Session ， 应 用 程序 就 不 需要 
同步 任何 业务 对 象 。 在 Session 的 范围 内 ， 应 用 程序 可 以 放心 的 使 用 == 进行 对 
象 比 较 。 


不 过 ， 应 用 程序 在 Session 的 外 面 使 用 == 进行 对 象 比较 可 能 会 导致 无 法 预期 的 
结果 。 在 一 些 无 法 预料 的 场合 ， 例 如 ， 如 果 你 把 两 个 脱 管 对 象 实例 放 进 同一 个 
Set 的 时 候 ， 就 可 能 发 生 。 这 两 个 对 象 实例 可 能 有 同一 个 数据 库 标 识 (也 就 是 
说 ， 他 们 代表 了 表 的 同一 行 数据 ) ， 从 JVM 标 识 的 定义 上 来 说 ， 对 脱 管 的 对 象 而 
言 ，Hibernate 无 法 保证 他 们 的 的 JVM 标 识 一 致 。 开 发 人 员 必 须 履 盖 持 久 化 类 

的 equals() 方法 和 hashcode() 方法 ， 从 而 实现 自 定 义 的 对 象 相 等 语义 。 和 警 
告 : 不 要 使 用 数据 库 标识 来 实现 对 象 相 等 ， 应 该 使 用 业务 键 值 ， 由 唯一 的 ， 通 常 不 
变 的 属性 组 成 。 当 一 个 瞬时 对 象 被 持久 化 的 时 候 ， 它 的 数据 库 标 识 会 发 生 改 变 。 如 
果 一 个 瞬时 对 象 《通常 也 包括 脱 管 对 象 实例 ) 被 放 入 一 个 Set ， 改 变 它 的 
hashcode 会 导致 与 这 个 set 的 关系 中 断 。 虽 然 业 务 键 值 的 属性 不 象 数 据 库 主键 那 
样 稳定 不 变 ， 但 是 你 只 需要 保证 在 同一 个 set 中 的 对 象 属性 的 稳定 性 就 足够 了 。 
请 到 Hibernate 网 站 去 寻求 这 个 问题 更 多 的 详细 的 讨论 。 请 注意 ， 这 不 是 一 个 有 关 
Hibernate 的 问题 ， 而 仅仅 是 一 个 关于 Java 对 象 标 识 和 判 等 行为 如 何 实现 的 问题 。 


11.1.4. 常见 问题 


决 不 要 使 用 反 模 式 session-per-user-session 或 者 session-per-application (当然 ， 
这 个 规定 几乎 没有 例外 ) 。 请 注意 ， 下 述 一 些 问 题 可 能 也 会 出 现在 我 们 推荐 的 模式 


中 ， 


在 你 作出 某 个 设计 决定 之 前 ， 请 务必 理解 该 模式 的 应 用 前 提 。 


Session 对 象 是 非 线程 安全 的 。 如 果 一 个 Session 实例 允许 共享 的 话 ， 那 
些 支持 并 发 运行 的 东 东 ， 例 如 HTTP request，session beans, 或 者 是 Swing 
workers， 将 会 导致 出 现 资源 争 用 (race condition) 。 如 果 

在 HttpSession 中 有 Hibernate 的 Session 的 话 ( 稍 后 讨论 ) ， 你 应 该 考 
虑 同步 访问 你 的 Http session, 否则 ， 只 要 用 户 足 够 快 的 点 击 浏览 器 的 "“ 刷 
新 ”， 就 会 导致 两 个 并 发 运行 线程 使 用 同一 个 Session o 


一 个 由 Hibernate 抛 出 的 异常 意味 着 你 必须 立即 回 滚 数 据 库 事务 ， 并 立即 关 

闭 Session  ( 稍 后 会 展开 讨论 ) 。 如 果 你 的 Session 绑 定 到 一 个 应 用 程序 
上 ， 你 必 须 停 止 该 应 用 程序 。 回 滚 数据 库 事 务 并 不 会 把 你 的 业务 对 象 退回 到 事 
务 启 动 时 候 的 状态 。 这 意味 着 数据 库 状 态 和 业务 对 象 状 态 不 同步 。 通 常情 况 
下 ， 这 不 是 什么 问题 ， 因 为 异常 是 不 可 恢复 的 ,你 必须 在 回 滚 之 后 重新 开始 执 
行 。 

Session 缓存 了 处 于 持久 化 状态 的 每 个 对 象 (Hibernate 会 监视 和 检查 脏 数 
据 ) 。 这 意味 着 ， 如 果 你 让 Session 打开 很 长 一 段 时 间 ， 或 是 仅仅 载 人 了 过 
多 的 数据 ， Session 占用 的 内 存 会 一 直 增 长 ， 直 到 抛 出 
OutOfMemoryException 异 常 。 这 个 问题 的 一 个 解决 方法 是 调用 clear() 

和 evict() 来 管理 Session 的 缓存 ， 但 是 如 果 你 需要 大 批量 数据 操作 的 
话 ， 最 好 考虑 使 用 存储 过 程 。 在 第 13 章 批量 处 理 (Batch processing) 中 有 
一 些 解 决 方案 。 在 用 户 会 话 期 间 一 直 保持 session 打开 也 意味 着 出 现 脏 数据 
的 可 能 性 很 高 。 


11.2. 数据 库 事 务 声明 


数据 库 (RERA) 事务 的 声明 总 是 必须 的 。 在 数据 库 事 务 之 外 ， 就 无 法 和 数据 库 
通讯 (这 可 能 会 让 那些 习惯 于 自动 提交 事务 模式 的 开发 人 员 感 到 迷惑 ) 。 永 远 使 用 
清晰 的 事务 声明 ， 即 使 只 读 操作 也 是 如 此 。 进 行 显 式 的 事务 声明 并 不 总 是 需要 的 ， 
这 取决 于 你 的 事务 隔离 级 别 和 数据 库 的 能 力 ， 但 不 管 怎么 说 ， 声 明 事 务 总 及 有 益 无 
害 。 rat 一 个 单独 的 数据 库 事务 总 是 比 很 多 琐碎 的 事务 性 能 更 好 ， 即 时 对 读数 据 
而 言 也 是 一 样 。 


一 个 Hibernate 应 用 程序 可 以 运行 在 非 托 管 环境 中 (也 就 是 独立 运行 的 应 用 程序 ， 简 
单 Web 应 用 程序 ， 或 者 Swing 图 形 桌 面 应 用 程序 ) ， 也 可 以 运行 在 托管 的 J2EE 环 

境 中 。 在 一 个 非 托 管 环境 中 ，Hibernate 通常 自己 负责 管理 数据 库 连 接 池 。 应 用 程 

序 开发 人 员 必 须 手工 设置 事务 声明 ， 换 句 话说 ， 就 是 手工 启 动 ， 提 交 ， 或 者 回 滚 数 
据 库 事务 。 一 个 托管 的 环境 通常 提供 了 容器 管理 事务 (CMT)， 例 如 事务 装配 通过 可 
E 明 的 方式 定义 在 EJB session beans 的 部 署 描述 符 中 。 可 编程 式 事务 声明 不 再 需 
要 ， 即 使 是 session 的 同步 也 可 以 自动 完成 。 


让 持久 层 具备 可 移植 性 是 人 们 的 理想 ,这 种 移植 发 生 在 非 托管 的 本 地 资源 环境 ， 与 依 
赖 JTA 但 是 使 用 BMT 而 非 CMT 的 系统 之 间 。 在 两 种 情况 下 你 都 可 以 使 用 编程 式 的 事 
务 管理 。Hibernate 提 供 了 一 套 称 为 Transaction 的 封装 API， 用 来 把 你 的 部 署 环 
境 中 的 本 地 事务 管理 系统 转换 到 Hibernate 事 务 上 。 这 个 API 是 可 选 的 ， 但 是 我 们 强 
烈 推荐 你 使 用 ， 除 非 你 用 CMT session bean. 


通常 情况 下 ， 结 束 Session 包含 了 四 个 不 同 的 阶段 : 
e 同步 session(flush, 刷 出 到 磁盘 ) 
。 提交 事务 
e 关闭 session 
。 处 理 异常 


session 的 同步 (flush, 刷 出 ) 前 面 已 经 讨论 过 了 ， 我 们 现在 进一步 考察 在 托管 和 非 托 
管 环境 下 的 事务 声明 和 异常 处 理 。 


11.2.1. 非 托 管 环境 


如 果 Hibernat 持 久 层 运行 在 一 个 非 托 管 环境 中 ， 数 据 库 连接 通常 由 Hibernate 的 简单 
( 即 非 DataSource) 连 接 池 机 制 来 人 处理 。session/transaction 钦 理 方式 如 下 所 示 : 


//Non-managed environment idiom 
Session sess = factory.openSession(); 
Transaction tx = null; 


try { 
tx = sess.beginTransaction(); 


// do some work 


tx.commit(); 


catch (RuntimeException e) { 
if (tx != null) tx.rollback(); 
throw e; // or display error message 


} 

finally { 
sess.close(); 

} 


你 不 需要 显 式 flush() Session -对 commit() 的 调用 会 自动 触发 session 的 
同步 (取决 于 session 的 第 10.10 节 “Session 刷 出 (flush)》)。 调 用 close() 标志 

session 的 结束 。 close( ) 方法 重要 的 暗示 是 ， session 释放 了 JDBC 连 接 。 这 
段 Java 代 码 在 非 托 管 环境 下 和 JTA 环 境 下 都 可 以 运行 。 


更 加 灵活 的 方案 是 Hibernate 内 置 的 "current session" 上 下 文 管 理 ， 前 文 已 经 讲 过 : 
// Non-managed environment idiom with getCurrentSession() 
try { 


factory.getCurrentSession().beginTransaction(); 


// do some work 


factory.getCurrentSession().getTransaction().commit(); 


catch (RuntimeException e) { 
factory.getCurrentSession().getTransaction().rollback(); 
throw e; // or display error message 


你 很 可 能 从 未 在 一 个 通常 的 应 用 程序 的 业务 代码 中 见 过 这 样 的 代码 片断 : 致命 的 
(RA) 异常 应 该 总 是 在 应 用 程序 “顶层 "被 捕获 。 换 句 话 说， 执行 Hibernate 调 用 的 
代码 (在 持久 层 ) 和 人 处理 RuntimeException 异常 的 代码 (通常 只 能 清理 和 退出 
应 用 程序 ) 应 该 在 不 同 的 应 用 程序 逻辑 层 。Hibernate 的 当前 上 下 文 管理 可 以 极 大 
地 简化 这 一 设计 ， 你 所 有 的 一 切 就 是 SessionFactory. 异常 处 理 将 在 本 章 稍 后 
进行 讨论 。 

请 注意 ， 你 应 该 选择 org.hibernate.transaction. JDBCTransactionFactory 
(这 是 默认 选项 )， 对 第 二 个 例子 来 


说 ， hibernate.current_session_context_class 应 该 是 "thread" 


11.2.2. 使 用 JTA 


如 果 你 的 持久 层 运行 在 一 个 应 用 服务 器 中 (例如 ， 在 EJB session beans 的 后 

面 ) ，Hibernate 获 取 的 每 个 数据 源 连接 将 自动 成 为 全 局 JTA 事 务 的 一 部 分 。 你 可 
以 安装 一 个 独立 的 JTA 实 现 ， 使 用 它 而 不 使 用 EJB。Hibernate 提 供 了 两 种 策略 进行 
JTA K. 


如 果 你 使 用 bean 管 理事 务 (BMT) ， 可 以 通过 使 用 Hibernate 的 Transaction 
APl 来 告诉 应 用 服务 器 启动 和 结束 BMT 事 务 。 因 此 ， 事 务 管理 代码 和 在 非 托 管 环境 
下 是 一 样 的 。 


// BMT idiom 
Session sess = factory.openSession(); 
Transaction tx = null; 


try { 
tx = sess.beginTransaction(); 


// do some work 


tx.commit(); 


catch (RuntimeException e) { 
if (tx != null) tx.rollback(); 
throw e; // or display error message 


} 

finally { 
sess.close(); 

} 


如 果 你 希望 使 用 与 事务 绑 定 的 Session ， 也 就 是 使 用 getcurrentSession() 来 
简化 上 下 文 管理 ， 你 将 不 得 不 直接 使 用 JTA UserTransaction API, 


// BMT idiom with getCurrentSession() 


try { 
UserTransaction tx = (UserTransaction)new InitialContext() 


. Lookup("java:comp/UserTransaction"); 
tx.begin(); 


// Do some work on Session bound to transaction 
factory.getCurrentSession().load(...); 
factory.getCurrentSession().persist(...); 


tx.commit(); 


catch (RuntimeException e) { 
tx.rollback(); 
throw e; // or display error message 


[| 


在 CMT 方 式 下 ， 事 务 声明 是 在 session bean 的 部 署 描述 符 中 ， 而 不 需要 编程 。 
此 ， 代 码 被 简化 为 : 


// CMT idiom 
Session sess = factory.getCurrentSession(); 


// do some work 


在 CMT/EJB 中 其 至 会 自动 rollback， 因 为 假若 有 未 捕获 的 RuntimeException 从 

session bean 方 法 中 抛 出 ， 这 就 会 通知 容器 把 全 局 事务 回 滚 。 这 就 意味 着 ， 在 BMT 
或 者 CMT 中 ， 你 根本 就 不 需要 使 用 Hibernate Transaction API， 你 自动 得 到 了 
绑 定 到 事务 的 “当前 ”Session。 


注意 ， 当 你 配置 Hibernate 的 transaction factory 的 时 候 ， 在 直接 使 用 JTA 的 时 候 
(BMT) ， 你 应 该 选 

择 org.hibernate.transaction.JTATransactionFactory ,在 CMT session 

bean 中 选择 org.hibernate.transaction.CMTTransactionFactory 。 记 得 也 要 

设置 hibernate.transaction.manager_lookup_class 。 还 有 ， 确 认 你 

的 hibernate.current_session_context_class 未 设置 (为 了 向 下 兼容 ) ， 或 

者 设置 为 "jta" 。 


getCurrentSession() 在 JTA 环 境 中 有 一 个 疾 端 。 对 after_statement 连接 释 
放 方 式 有 一 个 警告 ， 这 是 被 默认 使 用 的 。 因 为 JTA 规 范 的 一 个 很 思春 的 限制 ， 
Hibernate 不 可 能 自动 清理 任何 未 关闭 的 ScrollableResults 或 者 Iterator , 
它们 是 由 scroll() 或 iterate() 产生 的 。 你 must 通 过 在 finally 块 中 ， 显 式 


调用 ScrollableResults.close() 或 者 Hibernate.close(Iterator) 方法 来 
释放 底层 数据 库 游 标 。( 当 然 ， 大 部 分 程序 完全 可 以 很 容易 的 避免 在 JTA 或 CMT 代 码 
中 出 现 scroll() 或 iterate() 。) 


11.2.3. Hip Rie 


如 果 Session 抛 出 异常 (包括 任何 SQLException ), 你 应 该 立即 回 滚 数据 库 事 
务 ， 调 用 Session.close() , AiR Session 实例 。 Session 的 某 些 方法 
可 能 会 导致 session 处 于 不 一 致 的 状态 。 所 有 由 Hibernate 抛 出 的 异常 都 视 为 不 可 以 
TREE, PARTE finally 代码 块 中 调用 close() 方法 ， 以 关闭 掉 Session 。 


HibernateException 是 一 个 非 检 查 期 异常 (这 不 同 于 Hibernate 老 的 版 本 ) ， € 
封装 了 Hibernate 持 久 层 可 能 出 现 的 大 多 数 错误 。 我 们 的 观点 是 ， 不 应 该 强迫 应 用 程 
序 开 发 人 员 在 底层 捕获 无 法 恢复 的 有 异常。 在 大 多 数 软 件 系统 中 ， 非 检查 期 异常 和 致 
命 异常 都 是 在 相应 方法 调用 的 堆栈 的 顶层 被 处 理 的 (也 就 是 说 ， 在 软件 上 面 的 逻辑 
层 ) ， 并 且 提 供 一 个 错误 信息 给 应 用 软件 的 用 户 (或 者 采取 其 他 某 些 相 应 的 操 

作 ) 。 请 注意 ，Hibernate 也 有 可 能 抛 出 其 他 并 不 属于 HibernateException 的 非 
检查 期 异常 。 这 些 异常 同 祥 也 是 无 法 恢复 的 ， 应 该 采取 某 些 相应 的 操作 去 义理 。 


在 和 数据 库 进 行 交 互 时 ，Hibernate 把 捕获 的 SQLException 封装 为 Hibernate 的 
JDBCException 。 事 实 上 ，Hibernate 党 试 把 异常 转换 为 更 有 实际 含义 

的 JDBCException 异常 的 子 类 。 底 层 的 SQLException 可 以 通 

过 JDBCException.getCause() 来 得 到 。Hibernate 通 过 使 用 关联 到 
SessionFactory 上 的 SQLExceptionConverter 来 把 SQLException 转换 为 
一 个 对 应 的 JDBCException 异常 的 子 类 。 默 认 情 况 

F, SQLExceptionConverter 可 以 通过 配置 dialect 选项 指定 ; 此 外 ， 也 可 以 使 
用 用 户 自 定义 的 实现 类 (参考 javadocs SQLExceptionConverterFactory 类 来 了 
解 详情 ) 。 标 准 的 JDBCException 子 类 型 是 : 


e JDBCConnectionException -指明 底层 的 JDBC 通 讯 出 现 错误 
e SQLGrammarException -指明 发 送 的 SQL 语句 的 语法 或 者 格式 错误 
e ConstraintViolationException -指明 某 种 类 型 的 约束 违例 错误 


e LockAcquisitionException -指明 了 在 执行 请 求 操作 时 ， 获 取 所 需 的 锁 级 
别 时 出 现 的 错误 。 


e GenericJDBCException -不 属于 任何 其 他 种 类 的 原生 异常 


11.2.4. 事务 超时 


EJB 这 样 的 托管 环境 有 一 项 极为 重要 的 特性 ， 而 它 从 未 在 非 托管 环境 中 提供 过 ， 那 
就 是 事务 超时 。 在 出 现 错误 的 事务 行为 的 时 候 ， 超 时 可 以 确保 不 会 无 限 挂 起 资源 、 
对 用 户 没 有 交代 。 在 托管 (JTA) 环 境 之 外 ，Hibernate 无 法 完全 提供 这 一 功能 。 但 
是 ，Hiberante 至 少 可 以 控制 数据 访问 ， 确 保 数据 库 级 别 的 死 锁 ， 和 返回 巨大 结果 集 
的 查询 被 限定 在 一 个 规定 的 时 间 内 。 在 托管 环境 中 ，Hibernate 会 把 事务 超时 转交 给 
JTA。 这 一 功能 通过 Hibernate Transaction 对 象 进行 抽象 。 


Session sess = factory.openSession(); 


try { 
//set transaction timeout to 3 seconds 


sess.getTransaction().setTimeout(3); 
sess.getTransaction().begin(); 


// do some work 


sess.getTransaction().commit() 


catch (RuntimeException e) { 
sess.getTransaction().rollback(); 
throw e; // or display error message 


} 

finally { 
sess.close(); 

} 


注意 setTimeout() 不 应 该 在 CMT bean 中 调用 ， 此 时 事务 超时 值 应 该 是 被 声明 式 
定义 的 。 


11.3. 乐观 并 发 控制 (Optimistic concurrency 
control) 


唯一 能 够 同时 保持 高 并 发 和 高 可 伸缩 性 的 方法 就 是 使 用 带 版 本 化 的 乐观 并 发 控制 。 
版 本 检查 使 用 版 本 号 、 或 者 时 间 戳 来 检测 更 新 冲突 (并且 防止 更 新 丢失 ) 。 
Hibernate 为 使 用 乐观 并 发 控制 的 代码 提供 了 三 种 可 能 的 方法 ， 应 用 程序 在 编写 这 
些 代 码 时 ， 可 以 采用 它们 。 我 们 已 经 在 前 面 应 用 程序 对 话 那 部 分 展示 了 乐观 并 发 控 
oe 此 外 ， 在 单个 数据 库 事务 范围 内 ， 版 本 检查 也 提供 了 防止 更 新 去 失 
J 好处。 


11.3.1. 应 用 程序 级 别 的 版 本 检查 (Application 
version checking) 


未 能 充分 利用 Hibernate 功 能 的 实现 代码 中 ， 每 次 和 数据 库 交 互 都 需要 一 个 新 的 
Session ， 而 且 开 发 人 员 必 须 在 显示 数据 之 前 从 数据 库 中 重 新 载 人 所 有 的 持久 化 
对 象 实例 。 这 种 方式 迫使 应 用 程序 自己 实现 版 本 检查 来 确保 对 话 事务 的 隔离 ， 从 数 
据 访 问 的 角度 来 说 是 最 低 效 的 。 这 种 使 用 方式 和 entity EJB 最 相似 。 


// foo is an instance loaded by a previous Session 
session = factory.openSession(); 
Transaction t = session.beginTransaction(); 


int oldVersion = foo.getVersion(); 

session.load( foo, foo.getKey() ); // load the current state 

if ( oldVersion!=foo.getVersion ) throw new StaleObjectStateExcept: 
foo.setProperty("bar"); 


t.commit(); 
session.close(); 


BIE 


version 属性 使 用 &lt;version&gt， 来 映射 ， 如 果 对 象 是 脏 数 据 ， 在 同步 的 
时 候 ，Hibernate 会 自动 增加 版 本 号 。 


当然 ， 如 果 你 的 应 用 是 在 一 个 低 数 据 并 发 环境 下 ， 并 不 需要 版 本 检查 的 话 ， 你 照样 
可 以 使 用 这 种 方式 ， 只 不 过 跳 过 版 本 检查 就 是 了 。 在 这 种 情况 下 ， 最 晚 提 交 生 效 

(last commit wins) 就 是 你 的 长 对 话 的 默认 义理 策略 。 请 记 住 这 种 策略 可 能 会 让 

应 用 软件 的 用 户 感到 困惑 ， 因 为 他 们 有 可 能 会 磁 上 更 新 丢失 掉 却 没有 出 错 信息 ， 或 
者 需要 合并 更 改 冲突 的 情况 。 


很 明显 ， 手 工 进行 版 本 检查 只 适合 于 某 些 软件 规模 非常 小 的 应 用 场景 ， 对 于 大 多 数 
软件 应 用 场景 来 说 并 不 现实 。 通 常情 况 下 ， 不 仅 是 单个 对 象 实例 需要 进行 版 本 检 
查 ， 整 个 被 修改 过 的 关 联 对 象 图 也 都 需要 进行 版 本 检查 。 作 为 标准 设计 范例 ， 
Hibernate 使 用 扩展 周期 的 Session 的 方式 ， 或 者 脱 管 对 象 实例 的 方式 来 提供 自 
动 版 本 检查 。 





11.3.2. 扩展 周期 的 session 和 自动 版 本 化 


单个 Session 实例 和 它 所 关联 的 所 有 持久 化 对 象 实例 都 被 用 于 整个 对 话 ， 这 被 称 
为 Session-percomversation。Hibernate 在 同步 的 时 候 进 行 对 象 实例 的 版 本 检查 ， 

如 果 检 测 到 并 发 修 改 则 抛 出 异常 。 由 开发 人 员 来 决定 是 否 需要 捕获 和 处 理 这 个 异常 
i did 提供 一 个 合并 更 改 ， 或 者 在 无 脏 数据 情况 下 重新 进行 业务 对 
话 的 机 会 ) o 


在 等 待 用 户 交 互 的 时 候 ， Session 断 开 底层 的 JDBC 连 接 。 这 种 方式 以 数据 库 访 
问 的 角度 来 说 是 最 高 效 的 方式 。 应 用 程序 不 需要 关心 版 本 检查 或 脱 管 对 象 实例 NS 
新 关联 ， 在 每 个 数据 库 事务 中 ， 应 用 程序 也 不 需要 载 人 读 取 对 象 实例 。 


// foo is an instance loaded earlier by the old session 
Transaction t = session.beginTransaction(); // Obtain a new JDBC c1 


foo.setProperty("bar"); 


session.flush(); // Only for last transaction in conversation 
t.commit(); // Also return JDBC connection 
session.close(); // Only for last transaction in conversation 


| 


foo 对 象 知道 它 是 在 哪个 Session 中 被 装 入 的 。 在 一 个 旧 session 中 开启 一 个 新 
的 数据 库 事务 ， 会 导致 session 获 取 一 个 新 的 连接 ， 并 恢复 session 的 功能 。 将 数据 
库 事务 提交 ， 使 得 session 从 JDBC 连 接 断 开 ， 并 将 此 连接 交还 给 连接 池 。 在 重新 连 
接 之 后 ， 要 强制 对 你 没有 更 新 的 数据 进行 一 次 版 本 检查 ， 你 可 以 对 所 有 可 能 被 其 他 
事务 修改 过 的 对 象 ， 使 用 参数 LockMode.READ 来 调用 Session.lock() 。 你 不 
用 lock 任 何 你 正在 更 新 的 数据 。 一 般 你 会 在 扩展 的 Session Lik 

置 FLushMode .NEVER ， 因 此 只 有 最 后 一 个 数据 库 事务 循环 才 会 真正 的 吧 整 个 对 话 
中 发 生 的 修改 发 送 到 数据 库 。 因 此 ， 只 有 这 最 后 一 次 数据 库 事 务 才 会 包 

& flush() 操作 ， 然 后 在 整个 对 话 结束 后 ， 还 要 close() 这 个 session。 


如 果 在 用 户 思考 的 过 程 中 ， Session 因为 太 大 了 而 不 能 保存 ， 那 么 这 种 模式 是 有 
问题 的 。 举 例 来 说 ， 一 个 HttpSession 应 该 尽 可 能 的 小 。 由 于 Session 是 一 级 
缓存 ， 并 且 保 持 了 所 有 被 载 和 过 的 对 象 ， 因 此 我 们 只 应 该 在 那些 少量 的 
request/response 情 况 下 使 用 这 种 策略 。 你 应 该 只 把 一 个 Session 用 于 单个 对 
话 ， 因 为 它 很 快 就 会 出 现 脏 数据 。 


(注意 ， 早 期 的 Hibernate 版 本 需要 明确 的 对 Session 进行 disconnec 和 
reconnect。 这 些 方法 现在 已 经 过 时 了 ， 打 开 事 务 和 关闭 事务 会 起 到 同样 的 效果 。 ) 


此 外 ， 也 请 注意 ， 你 应 该 让 与 数据 库 连 接 断 开 的 Session 对 持久 层 保 持 关闭 状 
态 。 换 名 话说 ， 在 三 层 环 境 中 ， 使 用 有 状态 的 EJB session bean 来 持 

有 Session, 而 不 要 把 它 传递 到 web 层 〈 甚 至 把 它 序列 化 到 一 个 单独 的 层 ) ， 保 
存在 HttpSession 中 。 





扩展 session 模 式 ， 或 者 被 称 为 每 次 对 话 一 个 session(session-per-conversation), 在 
与 自动 管理 当前 session 上 下 文联 用 的 时 候 会 更 困难 。 你 需要 提供 你 自己 


++ 376 


的 CurrentSessionContext 实现 。 请 参阅 Hibernate Wiki 以 获得 示例 。 


11.3.3. 脱 管 对 象 (deatched object) 和 自动 版 本 化 


这 种 方式 下 ， 与 持久 化 存储 的 每 次 交互 都 发 生 在 一 个 新 的 Session 中 。 Am, fl 
一 持久 化 对 象 实 例 可 以 在 多 次 与 数据 库 的 交互 中 重用 。 应 用 程序 操纵 脱 管 对 象 实 例 
的 状态 ， 这 个 脱 管 对 象 实例 最 初 是 在 另 一 个 Session 中 载 人 的 ， 然 后 调用 
Session.update() , Session.saveOrUpdate() ,或 者 Session.merge() 


来 重新 关联 该 对 象 实例 。 


// foo is an instance loaded by a previous Session 
foo.setProperty("bar"); 

session = factory.openSession(); 

Transaction t = session.beginTransaction(); 
session.saveOrUpdate(foo); // Use merge() if "foo" might have been 
t.commit(); 

session.close(); 


4 — Ẹ 
Hibernate 会 再 一 次 在 同步 的 时 候 检 查 对 象 实例 的 版 本 ， 如 果 发 生 更 新 冲突 ， 就 抛 出 


异常 。 

如 果 你 确信 对 象 没有 被 修改 过 ， 你 也 可 以 调用 lock() 来 设置 

LockMode.READ 【〔 绕 过 所 有 的 缓存 ， 执 行 版 本 检查 ) ， 从 而 取代 update() 操 
作 。 





11.3.4. 定制 自动 版 本 化 行为 


对 于 特定 的 属性 和 集合 ， 通 过 为 它们 设置 映射 属性 optimistic-lock 的 值 
为 false ， 来 禁止 Hibernate 的 版 本 自动 增加 。 这 样 的 话 ， 如 果 该 属性 脏 数据 ， 
Hibernate 将 不 再 增加 版 本 号 。 


遗留 系统 的 数据 库 Schema 通 常 是 静态 的 ， 不 可 修改 的 。 或 者 ， 其 他 应 用 程序 也 可 
能 访问 同一 数据 库 ， 根 本 无 法 得 知 如 何 处 理 版 本 号 ， 甚 至 时 间 戳 。 在 以 上 的 所 有 场 
景 中 ， 实 现 版 本 化 不 能 依靠 数据 库 表 的 某 个 特定 列 。 在 &1t;class&gt; 的 映射 中 
设置 optimistic-lock="all" 可 以 在 没有 版 本 或 者 时 间 惟 属性 映射 的 情况 下 实 
m 版 本 检查 ， 此 时 Hibernate 将 比较 一 行 记录 的 每 个 字段 的 状态 。 请 注意 ， 只 有 当 
Hibernate 能 够 比 较 新 旧 状 态 的 情况 下 ， 这 种 方式 才能 生效 ， 也 就 是 说 ， 你 必须 使 
用 单个 长 生命 周期 Session 模式 ， 而 不 能 使 用 session-per-request-with- 
detached-objects 模 式 。 


有 些 情况 下 ， 只 要 更 改 不 发 生 交 错 ， 并 发 修改 也 是 允许 的 。 当 你 
在 &lt;class&gt; 的 映射 中 设置 optimistic-lock="dirty" ，Hibernate 在 同 
步 的 时 候 将 只 比较 有 脏 数据 的 字段 。 


在 以 上 所 有 场景 中 ， 不 管 是 专门 设置 一 个 版 本 /时 间 惟 列 ， 还 是 进行 全 部 字段 / 脏 数 
据 字段 比较 ， Hibernate 都 会 针对 每 个 实体 对 象 发 送 一 条 UPDATE 【〔 带 有 相应 的 
WHERE 语句 ) 的 SQL 语句 来 执行 版 本 检查 和 数据 更 新 。 如 果 你 对 关联 实体 设置 级 
联 关 系 使 用 传播 性 持久 化 (transitive persistence) ， 那 么 Hibernate 可 能 会 执行 不 
必 要 的 update 话 句 。 这 通常 不 是 个 问题 ， 但 是 数据 库 里 面 对 on update 点 火 的 触发 
器 可 能 在 脱 管 对 象 没有 任何 更 改 的 情况 下 被 触发 。 因 此 ， 你 可 以 在 
&lt;class&gt; 的 映射 中 ， 通 过 设置 select-before-update="true" 来 定制 
这 一 行为 ， 强 制 Hibernate SELECT 这 个 对 象 实例 ， 从 而 保证 ， 在 更 新 记录 之 前 ， 
对 象 的 确 是 被 修改 过 。 


11.4. Rn E (Pessimistic Locking) 


用 户 其 实 并 不 需要 花 很 多 精力 去 担心 锁定 策略 的 问题 。 通 常情 况 下 ， 只 要 为 JDBC 
连接 指定 一 下 隔离 级 别 ， 然 后 让 数据 库 去 搞定 一 切 就 够 了 。 然 而 ， 高 级 用 户 有 时 候 
希望 进行 一 个 排 它 的 翡 观 锁定 ， 或 者 在 一 个 新 的 事务 启动 的 时 候 ， 重 新 进行 锁定 。 


Hibernate 总 是 使 用 数据 库 的 锁定 机 制 ， 从 不 在 内 存 中 锁定 对 象 ! 


类 LockMode 定义 了 Hibernate 所 需 的 不 同 的 锁定 级 别 。 一 个 锁定 可 以 通过 以 下 的 
机 制 来 设置 : 


e 当 Hibernate 更 新 或 者 插入 一 行 记录 的 时 候 ， 锁 定 级 别 自动 设置 
为 LockMode ,WRITE 。 


oe 当 用 户 显 式 的 使 用 数据 库 支 持 的 SQL 格 式 SELECT ... FOR UPDATE 发 送 
SQL 的 时 候 ， 锁 定 级 别 设 置 为 LockMode .UPGRADE 


e 当 用 户 显 式 的 使 用 Oracle 数 据 库 的 SQL 语 
句 SELECT ... FOR UPDATE NOWAIT 的 时 候 ， 锁 定 级 别 设 
置 LockMode.UPGRADE_NOWAIT 


。 当 Hibernate 在 “可 重复 读 ” 或 者 是 “序列 化 ”数据库 隔 离 级 别 下 读 取 数据 的 时 候 ， 
锁定 模式 自动 设置 为 LockMode ,READ 。 这 种 模式 也 可 以 通过 用 户 显 式 指定 进 
行 设置 。 

e LockMode .NONE 代表 无 需 锁定 。 在 Transaction 结束 时 ， 所 有 的 对 象 都 
切换 到 该 模式 上 来 。 与 session 相 关联 的 对 象 通过 调用 update() 或 
者 saveorUpdate() 脱离 该 模式 。 


" 显 式 的 用 户 指定 "可 以 通过 以 下 几 种 方式 之 一 来 表示 : 
e 调用 Session.load() 的 时 候 指定 锁定 模式 (LockMode) o 
e 调用 Session.lock() © 
e 调用 Query.setLockMode() 。 


如 果 在 UPGRADE 或 者 UPGRADE_NOWAIT 锁定 模式 下 调用 Session.load() , # 
且 要 读 取 的 对 象 尚未 被 session 载 入 过 ， 那 么 对 象 通 

过 SELECT ... FOR UPDATE 这 桩 的 SQL 语句 被 裁 入 。 如 果 为 一 个 对 象 调 用 
load() 方法 时 ， 该 对 象 已 经 在 另 一 个 较 少 限制 的 锁定 模式 下 被 载 人 了 ， 那 么 
Hibernate 就 对 该 对 象 调用 lock() Aik. 


如 果 指 定 的 锁定 模式 是 READ, UPGRADE 或 UPGRADE_NOWAIT , JB 

么 Session.lock() 就 执行 版 本 号 检查 。 (在 UPGRADE 或 

者 UPGRADE_NOWAIT 锁定 模式 下 ， 执 行 SELECT ... FOR UPDATE 这 样 的 SQL 语 
句 。 ) 


如 果 数 据 库 不 支持 用 户 设置 的 锁定 模式 ，Hibernate 将 使 用 适当 的 替代 模式 (而 不 是 
扔 出 异常 ) 。 这 一 点 可 以 确保 应 用 程序 的 可 移植 性 。 


11.5. 连接 释放 模式 (Connection Release Modes) 


Hibernate 关 于 JDBC 连 接管 理 的 旧 (2.x) 行 为 是 ， Session 在 第 一 次 需要 的 时 候 获 
取 一 个 连接 ， 在 session 关 闭 之 前 一 直 会 持 有 这 个 连接 。Hibernate 引 入 了 连接 释放 
的 概念 ， 来 告诉 session 如 何 义理 它 的 JDBC 连 接 。 注 意 ， 下 面 的 讨论 只 适用 于 采用 
配置 ConnectionProvider 来 提供 连接 的 情况 ， 用 户 自 己 提供 的 连接 与 这 里 的 讨 
论 无 关 。 通 过 org.hibernate.ConnectionReleaseMode 的 不 同 枚 举 值 来 使 用 不 
用 的 释放 模式 : 


e oN CLOSE -基本 上 就 是 上 面 提 到 的 老式 行为 。Hibernate session 在 第 一 次 需 
要 进行 JDBC 操 作 的 时 候 获 取 连 接 ， 然 后 持 有 它 ， 直 到 session 关 闭 。 


e AFTER_TRANSACTION -在 org.hibernate.Transaction 结束 后 释放 连 
接 。 


e AFTER_STATEMENT (也 被 称 做 积极 释放 ) - 在 每 一 条 语句 被 执行 后 就 释放 连 
接 。 但 假若 语句 留 下 了 与 session 相 关 的 资源 ， 那 就 不 会 被 释放 。 目 前 唯一 的 这 
种 情形 就 是 使 用 org.hibernate.ScrollableResults 。 


hibernate.connection.release mode 配置 参数 用 来 指定 使 用 哪 一 种 释放 模 
式 。 可 能 的 值 有 : 


e auto (默认 ) - 这 一 选择 把 释放 模式 委派 
给 org.hibernate.transaction.TransactionFactory.getDefaultRelease 
方法 。 对 JTATransactionFactory 来 说 ， 它 会 返回 
ConnectionReleaseMode.AFTER STATEMENT; 对 JDBCTransactionFactory 
来 说 ， 则 是 ConnectionReleaseMode.AFTER_TRANSACTION。 很 少 需要 修 
改 这 一 默认 行为 ， 因 为 假若 设置 不 当 ， 就 会 带 来 bug， 或 者 给 用 户 代码 带 来 误 
导 。 


e on_close -使 用 ConnectionReleaseMode.ON_CLOSE. 这 种 方式 是 为 了 向 
下 兼容 的 ,但 是 已 经 完全 不 被 鼓励 使 用 了 。 


after_transaction -使 用 
ConnectionReleaseMode.AFTER_TRANSACTION。 这 一 设置 不 应 该 在 JTA 环 
境 下 使 用 。 也 要 注意 ， 使 用 
ConnectionReleaseMode.AFTER_TRANSACTION 的 时 候 ， 假 若 session % F 
auto-commit 状 态 ， 连 接 会 像 AFTER_STATEMENT 那 样 被 释放 。 


e after_statement - 使 用 ConnectionReleaseMode.AFTER_STATEMENT。 
除 此 之 外 ， 会 查询 配置 的 ConnectionProvider ， 是 否 它 支持 这 一 设置 
(( supportsAggressiveRelease() )) 。 假 若 不 支持 ， 释 放 模 式 会 被 设置 为 
ConnectionReleaseMode.AFTER_TRANSACTION。 只 有 在 你 每 次 调 
用 ConnectionProvider.getConnection() 获取 底层 JDBC 连 接 的 时 候 ， 都 
可 以 确信 获得 同一 个 连接 的 时 候 ， 这 一 设置 才 是 安全 的 ; 或 者 在 auto-commit 
环境 中 ， 你 可 以 不 管 是 否 每 次 都 获得 同一 个 连接 的 时 候 ， 这 才 是 安全 的 。 


第 12 章 拦截 器 与 事件 (Interceptors and events) 


目录 


e 12.1. 拦截 器 (Interceptors) 
e 12.2. 事件 系统 (Event system) 
e 12.3. Hibernate 的 声明 式 安全 机 制 


应 用 程序 能 够 响应 Hibernate 内 部 产生 的 特定 事件 是 非常 有 用 的 。 这 样 就 允许 实现 某 
些 通用 的 功能 以 及 允许 对 Hibernate 功 能 进行 扩展 。 


12.1. +4 #425(Interceptors) 


Interceptor ##O#et#t T MBié(session)[G1 44 (callback) š AFF (application) 
机 制 ， 这 种 回调 机 制 可 以 允许 应 用 程序 在 持久 化 对 象 被 保存 、 更 新 、 删 除 或 是 加 载 
之 前 ， 检 查 并 (或 ) 修改 其 属性 。 一 个 可 能 的 用 途 ， 就 是 用 来 跟踪 审核 (auditing) 
信息 。 例 如 : 下 面 的 这 个 拦截 器 ， 会 在 一 个 实现 了 Auditable 接口 的 对 象 被 创 
建 时 自动 地 设置 createTimestamp 属性 ， 并 在 实现 了 Auditable 接口 的 对 象 被 
更 新 时 ， 同 步 更 新 lastUpdateTimestamp 属性 。 


你 可 以 直接 实现 Interceptor 接口 ， 也 可 以 (最 好 ) 继承 
自 EmptyInterceptor 。 


package org.hibernate.test; 


import 
import 
import 


import 
import 
import 


public 


java.io.Serializable; 
java.util.Date; 
java.util.Iterator; 


org.hibernate.EmptyInterceptor; 
org.hibernate. Transaction; 
org.hibernate.type.Type; 


class AuditInterceptor extends EmptyInterceptor { 


private int updates; 
private int creates; 
private int loads; 


public void onDelete(Object entity, 


} 


Serializable id, 
Object[] state, 
String[] propertyNames, 
Type[] types) { 

// do nothing 


public boolean onFlushDirty(Object entity, 


Serializable id, 

Object[] currentState, 
Object[] previousState, 
String[] propertyNames, 


Type[] types) { 


if ( entity instanceof Auditable ) { 
updates++; 
for ( int i=0; i < propertyNames.length; i++ ) { 
if ( "lastUpdateTimestamp".equals( propertyNames[i_ 
currentState[i] = new Date(); 
return true; 


} 
} 
return false; 


} 


public boolean onLoad(Object entity, 

Serializable id, 
Object[] state, 
String[] propertyNames, 
Type[] types) { 

if ( entity instanceof Auditable ) { 

loads++; 
} 


return false; 


} 


public boolean onSave(Object entity, 
Serializable id, 
Object[] state, 
String[] propertyNames, 
Type[] types) { 


if ( entity instanceof Auditable ) { 
createst++; 
for ( int i=0; i<propertyNames.length; i++ ) { 
if ( "createTimestamp".equals( propertyNames[i] ) 
state[i] = new Date(); 
return true; 


} 
} 
return false; 


} 


public void afterTransactionCompletion(Transaction tx) { 
if ( tx.wasCommitted() ) { 


System.out.printin("Creations: " + creates + ", Updates 


updates=0; 
creates=0; 
loads=0; 





拦截 器 可 以 有 两 种 : Session 范围 内 的 ， 和 SessionFactory 范围 内 的 。 


当 使 用 某 个 重 载 的 SessionFactory.openSession() 使 用 Interceptor 作为 参数 调 
用 打开 一 个 session 的 时 候 ， 就 指定 了 Session 范围 内 的 拦截 器 。 


Session session = sf.openSession( new AuditInterceptor() ); 


SessionFactory 范围 内 的 拦截 器 要 通过 Configuration 中 注册 ， 而 这 必须 在 

创建 SessionFactory 之 前 。 在 这 种 情况 下 ， 给 出 的 拦截 器 会 被 这 

个 SessionFactory 所 打开 的 所 有 session 使 用 了 ; 除非 session 打 开 时 明确 指明 了 
使 用 的 拦截 器 。 SessionFactory 范围 内 的 拦截 器 ， 必 须 是 线程 安全 的 ， 因 为 多 

个 session 可 能 并 发 使 用 这 个 拦截 器 ， 要 因此 小 心 不 要 保存 与 session 相 关 的 状态 。 


new Configuration().setInterceptor( new AuditInterceptor() ); 


12.2. 事件 系统 (Event system) 


如 果 需 要 响应 持久 层 的 某 些 特殊 事件 ， 你 也 可 以 使 用 Hibernate3 的 事件 框架 。 该 事 
件 系 统 可 以 用 来 蔡 代 拦截 器 ， 也 可 以 作为 拦截 器 的 补充 来 使 用 。 


基本 上 ， Session 接口 的 每 个 方法 都 有 相对 应 的 事件 。 比 如 

LoadEvent , FlushEvent ， 等 等 〈 查 阅 XML 配 置 文件 的 DTD， 以 

及 org.hibernate.event 包 来 获得 所 有 已 定义 的 事件 的 列表 ) 。 当 某 个 方 法 被 
调用 时 ，Hibernate Session 会 生成 一 个 相对 应 的 事件 并 激活 所 有 配置 好 的 事件 
监听 器 。 系 统 预 设 的 监听 器 实现 的 处 理 过 程 就 是 被 监听 的 方法 要 做 的 (被 监听 的 方 
法 所 做 的 其 实 仅 仅 是 激活 监听 器 “实际” 的 工作 是 由 监听 器 完成 的 ) 。 不 过 ， 你 可 
以 自由 地 选择 实现 一 个 自己 定制 的 监听 器 (比如 ， 实 现 并 注册 用 来 处 理 处 

理 LoadEvent 的 LoadEventListener 接口 ) ， 来 负责 处 理 所 有 的 调 

用 session 的 load() 方法 的 请 求 。 


监听 器 应 该 被 看 作 是 单 例 (singleton) 对 象 ， 也 就 是 说 ， 所 有 同类 型 的 事件 的 处 理 共 
享 同一 个 监听 器 实例 ， 因 此 监听 器 不 应 该 保存 任何 状态 (也 就 是 不 应 该 使 用 成 员 变 


B) 


用 户 定制 的 监听 器 应 该 实现 与 所 要 义理 的 事件 相对 应 的 接口 ， 或 者 从 一 个 合适 的 基 
类 继承 (甚至 是 从 Hibernate 自 带 的 默认 事件 监听 器 类 继承 ， 为 了 方便 你 这 样 做 ， 
这 些 类 都 被 声明 成 non-final 的 了 ) 。 用 户 定制 的 监听 器 可 以 通过 编程 使 

FA Configuration 对 象 来 注册 ， 也 可 以 在 Hibernate 的 XML 格式 的 配置 文件 中 进 
行 声 明 (不 支持 在 Properties 格 式 的 配置 文件 声明 监听 器 ) 。 下 面 是 一 个 用 户 定制 
的 加 载 事件 (load event) 的 监听 器 : 


public class MyLoadListener implements LoadEventListener { 
// this is the single method defined by the LoadEventListener : 
public void onLoad(LoadEvent event, LoadEventListener.LoadType 
throws HibernateException { 
if ( !MySecurity.isAuthorized( event.getEntityClassName(), 
throw MySecurityException("Unauthorized access"); 





你 还 需要 修改 一 处 配置 ， 来 告诉 Hibernate， 除 了 默认 的 监听 器 ， 还 要 附加 选 定 的 监 
ITZ. 


<hibernate-configuration> 
<session-factory> 


<event type="load"> 
<listener class="com.eg.MyLoadListener"/> 
<listener class="org.hibernate.event.def.DefaultLoadEve 
</event> 
</session-factory> 
</hibernate-configuration> 


«| = 








看 看 用 另 一 种 方式 ， 通 过 编程 的 方式 来 注册 它 。 


Configuration cfg = new Configuration(); 
LoadEventListener[] stack = { new MyLoadListener(), new DefaultLoac 
cfg.EventListeners().setLoadEventListeners(stack); 


ee =- 


通过 在 XML 配置 文件 声明 而 注册 的 监听 器 不 能 共享 实例 。 如 果 在 多 

个 alt;listener/agt; 节点 中 使 用 了 相同 的 类 的 名 字 ， 则 每 一 个 引用 都 将 会 产 

生 一 个 独立 的 实例 。 如 果 你 需要 在 多 个 监听 器 类 型 之 间 共享 监听 器 的 实例 ， 则 你 必 
须 使 用 编程 的 方式 来 进行 注册 。 

为 什么 我 们 实现 了 特定 监听 器 的 接口 ， 在 注册 的 时 候 还 要 明确 指出 我 们 要 注册 哪个 
事件 的 监听 器 呢 ? 这 是 因为 一 个 类 可 能 实现 多 个 监听 器 的 接口 。 在 注册 的 时 候 明 确 
指定 要 监听 的 事件 ， 可 以 让 启用 或 者 禁用 对 某 个 事件 的 监听 的 配置 工作 简单 些 。 





12.3. Hibernate 的 声明 式 安全 机 制 


通常 ，Hibernate 应 用 程序 的 声明 式 安全 机 制 由 会 话 外 观 层 (session facade) 所 管 
理 。 现在 ，Hibernate3 允 许 某 些 特定 的 行为 由 JACC 进 行 许可 管理 ， 由 JAAS 进 行 授 
权 管 理 。 本 功能 是 一 个 建立 在 事件 框架 之 上 的 可 选 的 功能 。 


首先 ， 你 必须 要 配置 适当 的 事件 监听 器 (eventlistener) ， 来 激活 使 用 JAAS 管 理 
授权 的 功能 。 


<listener type="pre-delete" class="org.hibernate.secure.JACCPreDelt 
<listener type="pre-update" class="org.hibernate. secure. JACCPreUpdé 
<listener type="pre-insert" class="org.hibernate. secure. JACCPreInse 
<listener type="pre-load" class="org.hibernate.secure. JACCPreLoadE\ 


| _ : 





注意 ， Pelt listener type="..." class="..."/&gt; R 
是 &lt;event type="..."&gt;&lt;listener class="..."/&gt;&lt;/eventagti 


的 简写 ， 对 每 一 个 事件 类 型 都 必须 严格 的 有 一 个 监听 器 与 之 对 应 。 
接 下 来 ， 仍 然 在 hibernate.cfg.xml 文件 中 ， 绑 定 角 色 的 权限 : 


<grant role="admin" entity-name="User" actions="insert, update, read' 
<grant role="su" entity-name="User" actions="*"/> 





这 些 角色 的 名 字 就 是 你 的 JACC provider 所 定义 的 角色 的 名 字 。 


第 13 = 批量 处 理 (Batch processing) 


e 13.1. 批量 插入 (Batch inserts) 

e 13.2. 批量 更 新 (Batch updates) 

e 13.3. StatelessSession (无 状态 session) 接 口 

e 13.4. DML( 数 据 操 作 语 言 ) 风 格 的 操作 (DML-style operations) 


使 用 Hibernate 将 100 000 条 记录 插入 到 数据 库 的 一 个 很 自然 的 做 法 可 能 是 这 样 的 


Session session = sessionFactory.openSession(); 
Transaction tx = session. beginTransaction(); 
for ( int i=0; 1<100000; i++ ) { 
Customer customer = new Customer(..... WE 
session.save(customer ); 


} 
tx.commit(); 
session.close(); 


这 段 程 序 大 概 运 行 到 50 000 条 记录 左右 会 失败 并 抛 出 
内 存 渝 出 异常 (OutOfMemoryException) 。 这 是 因为 Hibernate 把 所 有 新 插入 的 
= (Customer) 实例 在 session 级 别 的 缓存 区 进行 了 缓存 的 缘故 。 


我 们 会 在 本 章 告诉 你 如 何 避 人 免 此 类 问题 。 首 先 ， 如 果 你 要 执行 批量 处 理 并 且 想 要 达 


到 一 个 理想 的 性 能 ， 那么 使 用 JDBC 的 批量 (batching) 功能 是 至 关 重 要 。 将 JDBC 
的 批量 抓 取 数 量 (batch size) 参数 设置 到 一 个 合适 值 (比如 ，10-50 之 间 ) 


hibernate.jdbc.batch_size 20 


<a class="calibre5 pcalibre pcalibre1" id="disablebatching"></a> 注 意 ,假若 你 使 用 
了 identiy 标识 符 生 成 器 ,Hibernate 在 JDBC 级 别 透明 的 关闭 插 和 人 语句 的 批量 执 
行 。 

你 也 可 能 想 在 执行 批量 处 理 时 关闭 二 级 缓存 : 


hibernate.cache.use second lJevel cache false 


但 是 ， 这 不 是 绝对 必须 的 ， 因 为 我 们 可 以 显 式 设置 CacheMode 来 关闭 与 二 级 缓存 


13.1. 批量 插入 (Batch inserts) 


如 果 要 将 很 多 对 象 持 久 化 ， 你 必须 通过 经 常 的 调用 flush() 以 及 稍 后 调用 
clear() 来 控制 第 一 级 缓存 的 大 小 。 


Session session = sessionFactory.openSession(); 
Transaction tx = session. beginTransaction(); 


for ( int i=0; i<100000; i++ ) { 
Customer customer = new Customer(..... iP 
session.save(customer ); 
if ( i % 20 == 0 ) { //20, same as the JDBC batch size //20, 5J 
//flush a batch of inserts and release memory: 
// 将 本 批 插入 的 对 象 立即 写 和 人 数据库 并 释放 内 存 
session.flush(); 
session.clear(); 


} 


tx.commit(); 
session.close(); 


二 





13.2. 批量 更 新 (Batch updates) 


此 方法 同样 适用 于 检索 和 更 新 数据 。 此 外 ， 在 进行 会 返回 很 多 行 数据 的 查询 时 ， 你 
需要 使 用 scrol1() 方法 以 便 充 分 利用 服务 器 端 游 标 所 带 来 的 好 处。 


Session session = sessionFactory.openSession(); 
Transaction tx = session. beginTransaction(); 


ScrollableResults customers = session.getNamedQuery("GetCustomers" 
. setCacheMode(CacheMode. IGNORE) 
.scroll(ScrollMode.FORWARD_ONLY); 

int count=0; 

while ( customers.next() ) { 

Customer customer = (Customer) customers.get(0); 
customer .updateStuff(...); 
if ( ++count % 20 == 0 ) { 
//flush a batch of updates and release memory: 
session.flush(); 
session.clear(); 


} 


tx.commit(); 
session.close(); 
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13.3. StatelessSession (无 状态 sessiom) 接 口 


作为 选择 ，Hibernate 提 供 了 基于 命令 的 API， 可 以 用 detached object 的 形式 把 数据 
以 流 的 方法 加 入 到 数据 库 ， 或 从 数据 库 输 出 。 StatelessSession 没有 持久 化 上 

下 文 ， 也 不 提供 多 少 高 层 的 生命 周期 语义 。 特 别 是 ， 无 状态 session 不 实现 第 一 级 

cache, 也 不 和 第 二 级 缓存 ， 或 者 查询 缓存 交互 。 它 不 实现 事务 化 写 ， 也 不 实现 脏 数 
据 检 查 。 用 stateless session 进 行 的 操作 甚至 不 级 联 到 关联 实例 。stateless session 
忽略 集合 类 (Collections)。 通 过 stateless session 进 行 的 操作 不 触发 Hibernate 的 事 

件 模 型 和 拦截 器 。 无 状态 session 对 数据 的 混淆 现象 免疫 ， 因 为 它 没有 第 一 级 缓存 。 
无 状态 session 是 低层 的 抽象 ， 和 低层 JDBC 相 当 接 近 。 


StatelessSession session = sessionFactory.openstatelessSession(); 
Transaction tx = session.beginTransaction(); 


ScrollableResults customers = session.getNamedQuery("GetCustomers" 
.scroll(ScrollMode.FORWARD_ONLY); 
while ( customers.next() ) { 
Customer customer = (Customer) customers.get(0); 
customer .updateStuff(...); 
session.update(customer ); 


} 


tx.commit(); 
session.close(); 


4 a O 


注意 在 上 面 的 例子 中 ， 坦 询 返 回 的 customer 实例 立即 被 脱 管 (detach)。 它 们 和 与 任 
何 持久 化 上 下 文 都 没有 关系 。 


StatelessSession 接口 定义 的 insert(), update() 和 delete() 操作 是 
直接 的 数据 库 行 级 别 操作 ， 其 结果 是 立刻 执行 一 条 INSERT, UPDATE 或 DELETE 
语句 。 因 此 ， 它 们 的 语义 和 Session 接口 定义 的 save()，saveorUpdate() 
和 delete() 操作 有 很 大 的 不 同 。 


13.4. DML( 数 据 操作 语言 ) 风 格 的 操作 (DML-style 
operations) 


hence manipulating (using the SQL Data Manipulation Language (DML) 
statements: INSERT , UPDATE , DELETE ) data directly in the database will not 
affect in-memory state. However, Hibernate provides methods for bulk SQL-style 
DML statement execution which are performed through the Hibernate Query 
Language (第 14 = HQL: Hibernate 查 询 语言 ). 就 像 已 经 讨论 的 那样 ， 自 动 和 透明 
的 对 象 /关系 映射 (object/relational mapping) 关注 于 管理 对 象 的 状态 。 这 就 意味 
着 对 象 的 状态 存在 于 内 存 ， 因 此 直接 操作 (使 用 SQL 

Data Manipulation Language (DML, 数 据 操作 语言 ) 语句 : INSERT 
, UPDATE 和 DELETE ) 数据 库 中 的 数据 将 不 会 影响 内 存 中 的 对 象 状态 和 对 象 数 
据 。 不 过 ，Hibernate 提 供 通 过 Hibernate 查 询 语言 (第 14 Æ HQL: Hibernate 查 询 
语言 ) 来 执行 大 批 量 SQL 风 格 的 DML 语 名 的 方法 。 


UPDATE 和 DELETE 语句 的 语法 为 : 
( UPDATE | DELETE ) FROM? EntityName (WHERE where_conditions)? 有 几 
点 说 明 : 


e 在 FROM 子 句 (from-clause) 中 ，FROM 关 键 字 是 可 选 的 


e 在 FROM 子 句 (from-clause) 中 只 能 有 一 个 实体 名 ， 它 可 以 是 别名 。 如 果实 体 
名 是 别名 ， 那 么 任何 被 引用 的 属性 都 必须 加 上 此 别名 的 前 级 ; 如 果 不 是 别名 ， 
那么 任何 有 前 级 的 属性 引用 都 是 非法 的 。 


。 不 能 在 大 批量 HQL 语 句 中 使 用 第 14.4 节 ‘join 语法 的 形式 ”( 星 式 或 者 隐 式 的 都 
不 行 ) 。 不 过 在 WHERE 子 句 中 可 以 使 用 子 查询 。 可 以 在 where 子 句 中 使 用 子 
查询 ， 子 查询 本 身 可 以 包含 join。 


。 整个 WHERE 子 句 是 可 选 的 。 


举 个 例子 ， 使 用 Query.executeUpdate() 方法 执行 一 个 HQL UPDATE 语句 ( : 
(方法 命名 是 来 源 于 JDBC's PreparedStatement ,executeUpdate() ): 


Session session = sessionFactory.openSession(); 
Transaction tx = session. beginTransaction(); 


String hqlUpdate = "update Customer c set c.name = :newName 
// or String hqlUpdate = "update Customer set name = :newN: 
int updatedEntities = s.createQuery( hqlUpdate ) 
.setString( "newName", newName ) 
.setString( "oldName", oldName ) 
.executeUpdate(); 
tx.commit(); 
session.close(); 








HQL UPDATE 语句， 默认 不 会 影响 更 新 实体 的 第 5.1.7 节 “ 版 本 (version) (可 
选 ) 或 者 第 5.1.8 $ “timestamp (可 选 ) 属 性 值 。 这 和 EJB3 规 范 是 一 致 的 。 但 是 ， 通 
过 使 用 versioned update ， 你 可 以 强制 Hibernate 正 确 的 重 置 version 或 

者 timestamp 属性 值 。 这 通过 在 UPDATE 关键 字 后 面 增加 VERSIONED 关键 字 来 
实现 的 。 


Session session = sessionFactory.openSession(); 
Transaction tx = session. beginTransaction(); 
String hqlVersionedUpdate = "update versioned Customer set name = 
int updatedEntities = s.createQuery( hqlUpdate ) 
.setString( "newName", newName ) 
.setString( "oldName", oldName ) 
.executeUpdate(); 
tx.commit(); 
session.close(); 


BJE 


注意 ， 自 定义 的 版 本 类 型 ( org.hibernate.usertype.UserVersionType ) 不 人 允许 
和 update versioned 语句 联 用 。 





执行 一 个 HQL DELETE ， 同 样 使 用 Query.executeUpdate() 方法 : 


Session session = sessionFactory.openSession(); 
Transaction tx = session. beginTransaction(); 


String hqlDelete = "delete Customer c where c.name = :oldNé 
// or String hqlDelete = "delete Customer where name = :olc 
int deletedEntities = s.createQuery( hqlDelete ) 
.setString( "oldName", oldName ) 
.executeUpdate(); 
tx.commit(); 
session.close(); 


FH Query.executeUpdate() 方法 返回 的 BH 值 表 明了 受 此 操作 影响 的 记录 数 
量 。 注意 这 个 数值 可 能 与 数据 库 中 被 (最 后 一 条 SQL 语句 ) 影响 了 的 “ 行 " 数 有 关 ， 
也 可 能 没有 。 一 个 大 批量 HQL 操 作 可 能 导致 多 条 实际 的 SQL 语句 被 执行 ， 举 个 例 
子 ， 对 joined-subclass 映 射 方式 的 类 进行 的 此 类 操作 。 这 个 返回 值 代 表 了 实际 被 语 
句 影响 了 的 记录 数量 。 在 那个 joined-subclass 的 例子 中 ， 对 一 个 子 类 的 删除 实际 上 
可 能 不 仅仅 会 删除 子 类 映射 到 的 表 而 且 会 影响 “ 根 " 表 ， 还 有 可 能 影响 与 之 有 继承 关 
系 的 joined-subclass 映 射 方式 的 子 类 的 表 。 


INSERT 语句 的 伪 码 是 : 
INSERT INTO EntityName properties_list select_statement . 要 注意 的 是 : 


e 只 支持 INSERT INTO ... SELECT ... 形 式 , 不 支持 INSERT INTO ... VALUES ... 
形式 . 





properties_list 和 SQL INSERT 语句 中 

的 字段 定义 (column speficiation) 类 似 。 对 参与 继承 树 映 射 的 实体 而 言 ， 
只 有 直接 定义 在 给 定 的 类 级 别 的 属性 才能 直接 在 properties_list 中 使 用 。 超 类 的 
属性 不 被 支持 ; 子 类 的 属性 无 意义 。 换 句 话 说 ， INSERT 天 生 不 支持 多 态 。 


e selectstatement 可 以 是 任何 合法 的 HQL 选 择 查 询 ， 不 过 要 保证 返回 类 型 必须 和 
要 插入 的 类 型 完全 匹配 。 目 前 ， 这 一 检查 是 在 查询 编译 的 时 候 进 行 的 ， 而 不 是 
把 它 交 给 数据 库 。 注 意 ， 在 Hibernate Type 间 如 果 只 是 等 价 (equivalent) 而 
非 相等 (equal) ， 会 导致 问题 。 定 义 
为 org.hibernate.type.DateType 和 org.hibernate.type.TimestampTyp 
的 两 个 属性 可 能 会 产生 类 型 不 匹配 错误 ， 虽 然 数据 库 级 可 能 不 加 区 分 或 者 可 以 
义理 这 种 转换 。 


e 对 id 属性 来 说 ,insert 语 名 给 你 两 个 选择 。 你 可 以 明确 地 在 properties _list#e Fis 
定 id 属 性 (这样 它 的 值 是 从 对 应 的 select 表 达 式 中 获得 ) ， 或 者 在 
properties_list 中 省 略 它 (此 时 使 用 生成 指 ) 。 后 一 种 选择 只 有 当 使 用 在 数据 库 
中 生成 值 的 id 产生 器 时 才能 使 用 ; 如 果 是 “内 存 " 中 计算 的 类 型 生成 器 ， 在 解析 
时 会 抛 出 一 个 异常 。 注 意 ， 为 了 说 明 这 一 问题 ， 数 据 库 产生 值 的 生成 器 
是 org.hibernate.id.SequenceGenerator (和 它 的 子 类 ) ， 以 及 任 
何 org.hibernate.id.PostInsertIdentifierGenerator 接口 的 实现 。 这 
儿 最 值得 注意 的 意外 是 org.hibernate.id.TableHiLoGenerator ， 它 不 能 
在 此 使 用 ， 因 为 它 没 有 得 到 其 值 的 途径 。 


e 对 映射 为 version 或 timestamp 的 属性 来 说 ，insert 语 句 也 给 你 两 个 选 
择 ， 你 可 以 在 properties_list 表 中 指定 (此 时 其 值 从 对 应 的 select 表 达 式 中 获 
得 ) ， 或 者 在 properties list 中 省 略 它 (此 时 ， 使 用 
在 org.hibernate.type.VersionType 中 定义 
的 seed value( 种 子 值 ) ) 。 


执行 HQL INSERT 语句 的 例子 如 下 : 


Session session = sessionFactory.openSession(); 
Transaction tx = session.beginTransaction(); 


String hqlInsert = "insert into DelinquentAccount (id, name) select 
int createdEntities = s.createQuery( hqlInsert ) 
.executeUpdate(); 
tx.commit(); 
session.close(); 
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14.1. 大 小 写 敏 感性 问题 

14.2. from 子 句 

14.3. 关联 (Association) 与 连接 (Join) 
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14.12. 子 查询 

14.13. HQL 示 例 

14.14. 批量 的 UPDATE 和 DELETE 
14.15. 小 技巧 & 小 窍门 


Hibernate 配 备 了 一 种 非常 强大 的 查询 语言 ， 这 种 语言 看 上 去 很 像 SQL。 但 是 不 要 被 
语法 结构 上 的 相似 所 迷惑 ，HQL 是 非常 有 意识 的 被 设计 为 完全 面向 对 象 的 查询 ， 它 
可 以 理解 如 继承 、 多 态 和 关联 之 类 的 概念 。 





14.1. 大 小 写 敏 感性 问题 


除了 Java 类 与 属性 的 名 称 外 ， 查 询 语句 对 大 小 写 并 不 敏感 。 所 以 Select & 
sELEct 以 及 SELECT 是 相同 的 ， 但 是 org.hibernate.eg.F00 并 不 等 价 于 
org.hibernate.eg.Foo 并 且 foo.barSet 也 不 等 价 于 foo.BARSET o 


本 手册 中 的 HQL 关 键 字 将 使 用 小 写字 母 . 很 多 用 户 发 现 使 用 完全 大 写 的 关键 字 会 使 
查询 语句 的 可 读 性 更 强 , 但 我 们 发 现 ， 当 把 查询 语句 族人 到 Java 话 句 中 的 时 候 使 用 
大 写 关 键 字 上 比较 难看 。 


14.2. from 子 句 
Hibernate 中 最 简单 的 查询 语句 的 形式 如 下 : 


from eg ,Cat 


该 子 句 简单 的 返回 eg.cat 类 的 所 有 实例 。 通常 我 们 不 需要 使 用 类 的 全 限定 名 ， 
A auto-import (自动 引入 ) 是 缺 省 的 情况 。 所 以 我 们 几乎 只 使 用 如 下 的 简单 
写法 : 


from Cat 


大 多 数 情 况 下 , 你 需要 指定 一 个 别名 , 原因 是 你 可 能 需要 在 查询 语句 的 其 它 部 分 引用 
到 cat 


from Cat as cat 


这 个 语句 把 别名 cat 指定 给 类 cat 的 实例 , 这 样 我 们 就 可 以 在 随后 的 查询 中 使 用 
此 别名 了 。 关键 字 as 是 可 选 的， 我们 也 可 以 这 样 写 ; 


from Cat cat 


子 句 中 可 以 同时 出 现 多 个 类 , 其 查询 结果 是 产生 一 个 笛 卡 儿 积 或 产生 跨 表 的 连接 。 


from Formula, Parameter 


from Formula as form, Parameter as param 


查询 语句 中 别名 的 开头 部 分 小 写 被 认为 是 实践 中 的 好 习惯 ， 这 样 做 与 Java 变 量 的 命 
名 标准 保持 了 一 致 (比如 ， domesticcat )。 


14.3. 关联 (Association) 与 连接 (Join) 


我 们 也 可 以 为 相关 联 的 实体 甚至 是 对 一 个 集合 中 的 全 部 元 素 指定 一 个 别名 , 这 时 要 
使 用 关键 字 join 。 


from Cat as cat 
inner join cat.mate as mate 
left outer join cat.kittens as kitten 


from Cat as cat left join cat.mate.kittens as kittens 


from Formula form full join form.parameter param 


受 支持 的 连接 类 型 是 从 ANSI SQL 中 借鉴 来 的 。 
e inner join (内 连接 ) 
e left outer join ( 左 外 连接 ) 
e right outer join ( 右 外 连接 ) 
e full join (全 连接 ! 并 不 常用 ) 


语句 inner join , left outer join 以 及 right outer join FAAS. 


from Cat as cat 
join cat.mate as mate 
left join cat.kittens as kitten 


通过 HQL 的 with 关键 字 ， 你 可 以 提供 额外 的 join 条 件 。 


from Cat as cat 
left join cat.kittens as kitten 
with kitten.bodyWeight > 10.0 


还 有 ， 一 个 "fetch" 连 接 允 许 仅 仅 使 用 一 个 选择 语句 就 将 相关 联 的 对 象 或 一 组 值 的 集 
合 随 着 他 们 的 父 对 象 的 初始 化 而 被 初始 化 ， 这 种 方法 在 使 用 到 集合 的 情况 下 尤其 有 
用 ， 对 于 关联 和 集合 来 说 ， 它 有 效 的 代替 了 映射 文件 中 的 外 联接 与 延迟 声明 (lazy 
declarations) . 查看 第 19.1 节 “ 抓 取 策 略 (Fetching strategies)” 以 获得 等 多 的 信 


自 
/PNO 


from Cat as cat 
inner join fetch cat.mate 
left join fetch cat.kittens 


一 个 fetch 连 接 通常 不 需要 被 指定 别名 , 因为 相关 联 的 对 象 不 应 当 被 用 在 _ where F 
句 (或 其 它 任何 子 句 ) 中 。 同 时 ， 相 关联 的 对 象 并 不 在 查询 的 结果 中 直接 返回 ， 但 可 
以 通过 他 们 的 父 对 象 来 访问 到 他 们 。 


from Cat as cat 
inner join fetch cat.mate 
left join fetch cat.kittens child 
left join fetch child.kittens 


假若 使 用 iterate() 来 调用 查询 ， 请 注意 fetch 构造 是 不 能 使 用 的 ( scroll() 
可 以 使 用 )。 fetch 也 不 应 该 与 setMaxResults() 或 setFirstResult() 共 

用 ， 这 是 因为 这 些 操作 是 基于 结果 集 的， 而 在 预先 抓 取 集 合 类 时 可 能 包含 重复 的 数 
据 ， 也 就 是 说 无 法 预先 知道 精确 的 行 数 。 fetch 还 不 能 与 独立 的 with 条 件 一 起 
使 用 。 通 过 在 一 次 查询 中 fetch 多 个 集合 ， 可 以 制造 出 笛 卡 尔 积 ， 因 此 请 多 加 注意 。 
对 bag 了 映射 来 说 ， 同 时 join fetch 多 个 集合 角色 可 能 在 某 些 情况 下 给 出 并 非 预 期 的 结 
果 ， 也 请 小 心 。 最 后 注意 ， 使 用 full join fetch 与 right join fetch 是 没 

意义 的 。 


如 果 你 使 用 属性 级 别 的 延迟 获取 (lazy fetching) (这 是 通过 重新 编写 字 节 码 实现 
BY) ， 可 以 使 用 fetch all properties 来 强制 Hibernate 立 即 取得 那些 原本 需 
要 延迟 加 载 的 属性 〈 在 第 一 个 查询 中 ) 。 


from Document fetch all properties order by name 


from Document doc fetch all properties where lower(doc.name) like 





14.4. join 语法 的 形式 


HQL 支 持 两 种 关联 join 的 形式 : implicit( 隐 式 ) 与 explicit ( 显 式 ) 。 


上 一 节 中 给 出 的 查询 都 是 使 用 explicit( 显 式 ) 形式 的 ， 其 中 form 子 句 中 明确 给 出 
了 join 关键 字 。 这 是 建议 使 用 的 方式 。 

implicit (mx) 形式 不 使 用 join 关键 字 。 关 联 使 用 "点 号 "来 进行 “ 引 

FA”. implicit join 可 以 在 任何 HQL 子 句 中 出 现 . implicit join 在 最 终 的 SQL 语 
句 中 以 inner join 的 方式 出 现 。 


from Cat as cat where cat.mate.name like '%s%' 


14.5. select 子 句 
select 子 句 选择 将 哪些 对 象 与 属性 返 回 到 查询 结果 集中 . 考虑 如 下 情 ; 


select mate 
from Cat as cat 
inner join cat.mate as mate 


该 语句 将 选择 mate sofother cat so (其 他 猫 的 配偶 ) 实际 上 , 你 可 以 更 简洁 
的 用 以 下 的 查询 语句 表达 相同 的 含义 : 


select cat.mate from Cat cat 


查询 语句 可 以 返回 值 为 任何 类 型 的 属性 ， 包 括 返 回 类 型 为 某 种 组 件 (Component) 的 
属性 : 


select cat.name from DomesticCat cat 
where cat.name like 'fri%' 


select cust.name.firstName from Customer as cust 


查询 语句 可 以 返回 多 个 对 象 和 (或) 属性， 存放 在 object[] 队列 中 ， 


select mother, offspr, mate.name 
from DomesticCat as mother 
inner join mother.mate as mate 
left outer join mother.kittens as offspr 


或 存放 在 一 个 List SRA, 


select new list(mother, offspr, mate.name) 
from DomesticCat as mother 

inner join mother.mate as mate 

left outer join mother.kittens as offspr 


也 可 能 直接 返回 一 个 实际 的 类 型 安全 的 Java 对 象 ， 


select new Family(mother, mate, offspr) 
from DomesticCat as mother 

join mother.mate as mate 

left join mother.kittens as offspr 


假设 类 Family A- DEEA ENAA. 


你 可 以 使 用 关键 字 as 给 "被 选择 了 的 表达 式 " 指 派别 名 


select max(bodyWeight) as max, min(bodyWeight) as min, count(*) as 
from Cat cat 





这 种 做 法 在 与 子 句 select new map 一 起 使 用 时 最 有 用 


select new map( max(bodyWeight) as max, min(bodyWeight) as min，col 
from Cat cat 





该 查询 返回 了 一 个 Map 的 对 象 ， 内 容 是 别名 与 被 选择 的 值 组 成 的 名 - 值 映 射 。 


14.6. 聚集 函数 
HQL 查 询 其 至 可 以 返回 作用 于 属性 之 上 的 聚集 函数 的 计算 结果 


select avg(cat.weight), sum(cat.weight), max(cat.weight), count(cat 
from Cat cat 


«| = 








SHARE SME : 
e avg(...), sum(...), min(...), max(...) 
e count(*) 
e count(...), count(distinct ...), count(all...) 


你 可 以 在 选择 子 句 中 使 用 数学 操作 符 、 连 接 以 及 经 过 验证 的 SQL 画 数 : 


select cat.weight + sum(kitten.weight ) 
from Cat cat 

join cat.kittens kitten 
group by cat.id, cat.weight 


select firstName||' '||initial||' '||upper(lastName) from Person 


关键 字 distinct 与 all 也 可 以 使 用 ， 它 们 具有 与 SQL 相同 的 语义 . 


select distinct cat.name from Cat cat 


select count(distinct cat.name), count(cat) from Cat cat 


14.7. 多 态 查询 
一 个 如 下 的 查询 语句 


from Cat as cat 


ARE] cat 类 的 实例 , 也 同时 返回 子 类 ”Domesticcat 的 实例 . Hibernate 可 以 
在 from 子 句 中 指定 任何 Java 类 或 接口 . 查询 会 返回 继承 了 该 类 的 所 有 持久 化 子 
类 的 实例 或 返回 声明 了 该 接口 的 所 有 持久 化 类 的 实例 。 下 面 的 查询 语句 返回 所 有 的 
被 持久 化 的 对 象 : 


from java.lang.Object 0 


接口 Named 可 能 被 各 种 各 样 的 持久 化 类 声明 : 


from Named n, Named m where n.name = m.name 


注意 ， 最 后 的 两 个 查询 将 需要 超过 一 个 的 SQL SELECT .这 表明 order by FA 没 
有 对 整个 结果 集 进 行 正确 的 排序 . (这 也 说 明 你 不 能 对 这 样 的 查询 使 
用 Query.scroll() 方法 .) 


14.8. where 子 句 


where 子 句 允许 你 将 返回 的 实例 列表 的 范围 缩小 . 如 果 没 有 指定 别名 ， 你 可 以 使 用 
属性 名 来 直接 引用 属性 : 


from Cat where name='Fritz' 


如 果 指 派 了 别名 ， 需 要 使 用 完整 的 属性 名 : 


from Cat as cat where cat.name='Fritz' 


返回 名 为 (属性 name 等 于 ) 'Fritz' 的 cat 类 的 实例 。 


select foo 
from Foo foo, Bar bar 
where foo.startDate = bar.date 


将 返回 所 有 满足 下 面条 件 的 Foo 类 的 实例 : 存在 如 下 的 bar 的 一 个 实例 ， 
其 date 属性 等 于 Foo 的 startDate 属性 。 复合 路 径 表 达 式 使 得 where 子 句 
非常 的 强大 ， 考 虑 如 下 情况 : 


from Cat cat where cat.mate.name is not null 


该 查询 将 被 翻译 成 为 一 个 含有 表 连 接 (内 连接 ) 的 SQL 查 询 。 如 果 你 打算 写 像 这 样 
的 查询 语句 


from Foo foo 
where foo.bar.baz.customer.address.city is not null 


在 SQL 中 ， 你 为 达 此 目的 将 需要 进行 一 个 四 表 连 接 的 查询 。 
= 运算 符 不 仅 可 以 被 用 来 比较 属性 的 值 ， 也 可 以 用 来 比较 实例 : 


from Cat cat, Cat rival where cat.mate = rival.mate 
select cat, mate 


from Cat cat, Cat mate 
where cat.mate = mate 


特殊 属性 OS) id 可 以 用 来 表示 一 个 对 象 的 唯一 的 标识 符 。 (你 也 可 以 使 用 该 
对 象 的 属性 名 。) 


from Cat as cat where cat.id = 123 


from Cat as cat where cat.mate.id = 69 


第 二 个 查询 是 有 效 的 。 此 时 不 需要 进行 表 连 接 ! 


同样 也 可 以 使 用 复合 标识 符 。 上 比如 Person 类 有 一 个 复合 标识 符 ， 它 
由 country 属性 与 medicareNumber 属性 组 成 。 


from bank.Person person 
where person.id.country = 'AU' 
and person.id.medicareNumber = 123456 


from bank.Account account 
where account.owner.id.country = 'AU' 
and account.owner.id.medicareNumber = 123456 


第 二 个 查询 也 不 需要 进行 表 连 接 。 


同样 的 ， 特 殊 属性 class 在 进行 多 态 持 久 化 的 情况 下 被 用 来 存 取 一 个 实例 的 鉴别 
值 (discriminator value) 。 一 个 伐 入 到 where 子 句 中 的 Java 类 的 名 字 将 被 转换 为 
该 类 的 鉴别 值 。 


from Cat cat where cat.class = DomesticCat 


你 也 可 以 声明 一 个 属性 的 类 型 是 组 件 或 者 复合 用 户 类 型 (以 及 由 组 件 构成 的 组 件 等 
等 ) 。 永 远 不 要 党 试 使 用 以 组 件 类 型 来 结尾 的 路 径 表 达 式 (path-expression) (4 
此 相反 ， 你 应当 使 用 组 件 的 一 个 属性 来 结尾 ) 。 举例 来 说 ， 如 果 store.owner £ 
有 一 个 包含 了 组 件 的 实体 address 


store.owner.address.city // 正确 
store.owner.address // 错误 ! 


一 个 “任意 ”类 型 有 两 个 特殊 的 属性 id 和 class ,来 允许 我 们 按照 下 面 的 方式 表达 
一 个 连接 ( AuditLog.item 是 一 个 属性 ， 该 属性 被 映射 为 &lt;any&gt; ) 。 


from AuditLog log, Payment payment 
where log.item.class = 'Payment' and log.item.id = payment.id 


注意 ， 在 上 面 的 查询 与 句 中 ， log.item.class 和 payment.class 将 涉及 到 完 
全 不 同 的 数据 库 中 的 列 。 


14.9. 表达 式 


在 where 子 句 中 人 允许 使 用 的 表达 式 包括 大 多 数 你 可 以 在 SQL 使 用 的 表达 式 种 类 : 


数学 运算 符 +，-，*，/ 
二 进 制 比较 运算 符 =, &gti=, &lt;=, &lt;&gt;, !=, like 
逻辑 运算 符 and, or, not 


in , not in, between , is null , is not null , is empty , 
is not empty , member of and not member of 


"简单 的 " case, case ... when ... then... else ... end ,和 "搜索 " 
case, case when ... then ... else ... end 
SORE ...|]... or concat(...,...) 


current_date() , current_time() , current_timestamp() 


second(...) , minute(...) , hour(...) , day(...) , month(...) , 
year(...), 

EJB-QL 3.0 定 义 的 任何 函数 或 操 

VE: substring(), trim(), lower(), upper(), length(), locate(), a 
coalesce() 和 nullif() 
str() 把 数字 或 者 时 间 值 转换 为 可 读 的 字符 串 


cast(... as ...) ,其 第 二 个 参数 是 某 Hibernate 类 型 的 名 字 ， 以 
及 extract(... from ,,,) ， 只 要 ANSI cast() 和 extract() 被 底层 
数据 库 支 持 


HQL index() 男 数 ， 作 用 于 join 的 有 序 集合 的 别名 。 
HQL 画 数 ， 把 集合 作为 参 


数 : size(), minelement(), maxelement(), minindex(), maxindex() , 


还 有 特别 的 elements() 和 indices WH, JA54 DAR 
定 : some, all, exists, any, in. 


Ete = LASALA ER, FEAD sign() , trunc() , rtrim() , 


sin() 
JDBC 风 格 的 参数 传人 ? 
命名 参数 :name ， :start_date , :x1 


SQL 直接 常量 'foo' ，69 ，6.66E+2 , '1970-01-01 10:00:01.0' 


e Java public static final 类 型 的 常量 eg.Color. TABBY 


关键 字 in | between 可 按 如 下 方法 使 用 : 


from DomesticCat cat where cat.name between 'A' and 'B' 


from DomesticCat cat where cat.name in ( 'Foo', 'Bar', 'Baz' ) 


而 且 否 定 的 格式 也 可 以 如 下 书写 : 


from DomesticCat cat where cat.name not between 'A' and 'B' 


from DomesticCat cat where cat.name not in ( 'Foo', 'Bar', 'Baz' ) 
Mes 
同样 , 子 句 is null 与 is not null 可 以 被 用 来 测试 空 值 (null). 


在 Hibernate 配 置 文件 中 声明 HQL“ 查 询 替 代 (query substitutions) ”之 后 ， ARR 
达 式 (Booleans) 可 以 在 其 他 表达 式 中 轻松 的 使 用 : 


<property name="hibernate.query.substitutions">true 1, false O</pr« 
[EE 


系统 将 该 HQL 转 换 为 SQL 语句 时 ， 该 设置 表明 将 用 字符 1 和 0 来 取代 关键 
字 true 和 false : 





from Cat cat where cat.alive = true 


你 可 以 用 特殊 属性 size , REIRA size() 测试 一 个 集合 的 大 小 。 


from Cat cat where cat.kittens.size > 0 


from Cat cat where size(cat.kittens) > 0 


对 于 索引 了 (AF) 的 集合 ， 你 可 以 使 用 minindex 与 maxindex 酌 数 来 引用 到 
最 小 与 最 大 的 索引 序数 。 同 理 ， 你 可 以 使 用 minelement 与 maxelement WRX 
来 引用 到 一 个 基本 数据 类 型 的 集合 中 最 小 与 最 大 的 元 素 。 


from Calendar cal where maxelement(cal.holidays) > current_date 
from Order order where maxindex(order.items) > 100 


from Order order where minelement(order.items) > 10000 


在 传递 一 个 集合 的 素 引 集 或 者 是 元 素 集 ( elements 与 indices HM) 或 者 传递 一 
个 子 查 询 的 结果 的 时 候 ， 可 以 使 用 SQL 画 数 any, some, all, exists, in 


select mother from Cat as mother, Cat as kit 
where kit in elements(foo.kittens) 


select p from NameList list, Person p 
where p.name = some elements(list.names) 


from Cat cat where exists elements(cat.kittens) 
from Player p where 3 > all elements(p.scores) 


from Show show where 'fizard' in indices(show.acts) 


注意 ， 在 Hibernate3 种 ， 这 些 结 构 变量 - size , elements , indices , 
minindex , maxindex , minelement , maxelement - 只 能 在 where 子 句 中 使 


用 。 
一 个 被 索引 过 的 (有 序 的 ) 集合 的 元 素 (arrays, lists, maps) 可 以 在 其 他 索引 中 被 引 
用 (只 能 在 where 子 名 中 ) : 


from Order order where order.items[0].id = 1234 


select person from Person person, Calendar calendar 
where calendar.holidays['national day'] = person.birthDay 
and person.nationality.calendar = calendar 


select item from Item item, Order order 
where order.items[ order.deliveredItemIndices[0] ] = item and orde! 
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select item from Item item, Order order 
where order.items[ maxindex(order.items) ] = item and order.id = 1: 


«| H B] 


在 [] 中 的 表达 式 甚 至 可 以 是 一 个 算数 表达 式 。 





select item from Item item, Order order 


where order.items[ size(order.items) - 1 ] item 


对 于 一 个 一 对 多 的 关联 (one-to-many association) 或 是 值 的 集合 中 的 元 素 ， HQL 
也 提供 内 建 的 index() BR, 


select item, index(item) from Order order 
join order.items item 
where index(item) < 5 


QOSR ES 2 Hee HiT BASOLWRN, Cita LRA 


from DomesticCat cat where upper(cat.name) like 'FRI%' 


如 果 你 还 不 能 对 所 有 的 这 些 深信 不 疑 ， 想 想 下 面 的 查询 。 如 果 使 用 SQL， 话 句 长 度 
会 增长 多 少 ， 可 读 性 会 下 降 多 少 : 


select cust 
from Product prod, 
Store store 
inner join store.customers cust 
where prod.name = 'widget' 
and store.location.name in ( 'Melbourne', 'Sydney' ) 
and prod = all elements(cust.currentOrder.lineItems) 


fem: 会 像 如 下 的 语句 


SELECT cust.name, cust.address, cust.phone, cust.id, cust.current_¢ 
FROM customers cust, 
stores store, 
locations loc, 
store_customers Sc, 
product prod 
WHERE prod.name = 'widget' 
AND store.loc_id = loc.id 
AND loc.name IN ( 'Melbourne', 'Sydney' ) 
AND sc.store_id = store.id 
AND sc.cust_id = cust.id 
AND prod.id = ALL( 
SELECT item.prod_id 
FROM line_items item, orders o 
WHERE item.order_id = o.id 
AND cust.current_order = o.id 





14.10. order by 子 句 


查询 返回 的 列表 (list) 可 以 按照 一 个 返回 的 类 或 组 件 (components) 中 的 任何 属性 
(property) 进行 排序 : 


from DomesticCat cat 
order by cat.name asc, cat.weight desc, cat.birthdate 


可 选 的 asc 或 desc 关键 字 指明 了 按照 升序 或 降序 进行 排序 . 


14.11. group by 子 句 


一 个 返回 聚集 值 (aggregate values) 的 查询 可 以 按照 一 个 返回 的 类 或 组 件 
(components) 中 的 任何 属性 (property) 进行 分 组 : 


select cat.color, sum(cat.weight), count(cat) 
from Cat cat 
group by cat.color 


select foo.id, avg(name), max(name) 
from Foo foo join foo.names name 
group by foo.id 


having 子 句 在 这 里 也 人 允许 使 用 . 


select cat.color, sum(cat.weight), count(cat) 

from Cat cat 

group by cat.color 

having cat.color in (eg.Color.TABBY, eg.Color.BLACK) 


I REE WHE EIS is (PIDOARBETEMySQL41E RR), SQLA-KRNASRER 
数 也 可 以 出 现在 having & order by FA, 


select cat 
from Cat cat 
Join cat.kittens kitten 
group by cat.id, cat.name, cat.other, cat.properties 
having avg(kitten.weight) > 100 
order by count(kitten) asc, sum(kitten.weight) desc 


注意 group by FHS order by 子 句 中 都 不 能 包含 算术 表达 式 (arithmetic 
expressions) . 也 要 注意 Hibernate 目 前 不 会 扩展 group 的 实体 ,因此 你 不 能 

写 group by cat ,除非 cat 的 所 有 属性 都 不 是 聚集 的 (non-aggregated)。 你 必须 
明确 的 列 出 所 有 的 非 聚 集 属性 。 


14.12. 于 查询 


对 于 支持 子 查询 的 数据 库 ，Hibernate 支 持 在 查询 中 使 用 子 查询 。 一 个 子 查询 必须 被 
圆 括 号 包围 起 来 (经 常 是 SQL 聚集 本 数 的 圆 括号 ) 。 甚至 相互 关联 的 子 查询 (引用 
到 外 部 查询 中 的 别名 的 子 查询 ) 也 是 允许 的 。 


from Cat as fatcat 
where fatcat.weight > ( 

select avg(cat.weight) from DomesticCat cat 
) 


from DomesticCat as cat 
where cat.name = some ( 

select name.nickName from Name as name 
) 


from Cat as cat 
where not exists ( 

from Cat as mate where mate.mate = cat 
) 


from DomesticCat as cat 
where cat.name not in ( 

select name.nickName from Name as name 
) 


select cat.id, (select max(kit.weight) from cat.kitten kit) 
from Cat as cat 


注意 ，HQL 自 查询 只 可 以 在 select 或 者 where 子 句 中 出 现 。 


在 select 列 表 中 包含 一 个 表达 式 以 上 的 子 查询 ， 你 可 以 使 用 一 个 元 组 构造 符 (tuple 
constructors) : 


from Cat as cat 
where not ( cat.name, cat.color ) in ( 

select cat.name, cat.color from DomesticCat cat 
) 


注意 在 某 些 数据 库 中 (不 包括 Oracle 与 HSQL) ， 你 也 可 以 在 其 他 语 境 中 使 用 元 组 
构造 符 ， 比如 查询 用 户 类 型 的 组 件 与 组 合 : 


from Person where name = ('Gavin', 'A', 'King') 


该 查询 等 价 于 更 复杂 的 : 


from Person where name.first = 'Gavin' and name.initial = 'A' and r 
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有 两 个 很 好 的 理由 使 你 不 应 当 作 这 样 的 事情 : 首先 ， 它 不 完全 适用 于 各 个 数据 库 平 
台 ; 其 次 ， 查 询 现在 依赖 于 映射 文件 中 属性 的 顺序 。 


14.13. HQL 示 例 


Hibernate 查 询 可 以 非常 的 强大 与 复 大 。 实 际 上 ，Hibernate 的 一 个 主要 卖点 就 是 查 
询 语 句 的 威力 。 这 里 有 一 些 例子 ， 它 们 与 我 在 最 近 的 一 个 项 目 中 使 用 的 查询 非常 相 
似 。 注 意 你 能 用 到 的 大 多 数 查 询 比 这 些 要 简单 的 多 | 


下 面 的 查询 对 于 某 个 特定 的 客户 的 所 有 未 支付 的 账单 ， 在 给 定 给 最 小 总 价值 的 情 ; 
下 ， 返 回 订 单 的 id， 条 目的 数量 和 总 价值 ， 返回 值 按照 总 价值 的 结果 进行 排序 。 为 
了 决定 价格 ， 查 询 使 用 了 当前 目录 。 作 为 转换 结果 的 SQL 查询 ， 使 用 了 ORDER , 
ORDER_LINE , PRODUCT , CATALOG 和 PRICE 库 表 。 


select order.id, sum(price.amount), count(item) 
from Order as order 
join order.lineItems as item 
join item.product as product, 
Catalog as catalog 
join catalog.prices as price 
where order.paid = false 
and order.customer = :customer 
and price.product = product 
and catalog.effectiveDate < sysdate 
and catalog.effectiveDate >= all ( 
select cat.effectiveDate 
from Catalog as cat 
where cat.effectiveDate < sysdate 
) 
group by order 
having sum(price.amount) > :minAmount 
order by sum(price.amount) desc 


这 简直 是 一 个 怪物 ! 实际 上 ， 在 现实 生活 中 ， 我 并 不 热衷 于 子 查询 ， 所 以 我 的 查询 
语句 看 起 来 更 像 这 个 : 


select order.id, sum(price.amount), count(item) 
from Order as order 

join order.lineItems as item 

join item.product as product, 

Catalog as catalog 

join catalog.prices as price 
where order.paid = false 


and order.customer = :customer 
and price.product = product 
and catalog = :currentCatalog 


group by order 
having sum(price.amount) > :minAmount 
order by sum(price.amount) desc 


下 面 一 个 查询 计算 每 一 种 状态 下 的 支付 的 数目 ， 除 去 所 有 你 

于 AWAITING_APPROVAL 状态 的 支付 ， 因 为 在 该 状态 下 当前 的 用 户 作 出 了 状态 的 
最 新 改变 。 该 查询 被 转换 成 含有 两 个 内 连接 以 及 一 个 相关 联 的 子 选 择 的 SQL 查 询 ， 
该 查询 使 用 了 表 PAYMENT , PAYMENT_STATUS 以 及 
PAYMENT_STATUS_CHANGE 。 


select count(payment), status.name 
from Payment as payment 
join payment.currentStatus as status 
join payment.statusChanges as statusChange 
where payment.status.name <> PaymentStatus.AWAITING_APPROVAL 
or ( 
statusChange.timeStamp = ( 
select max(change.timeStamp) 
from PaymentStatusChange change 
where change.payment = payment 
) 
and statusChange.user <> :currentUser 
) 
group by status.name, status.sortOrder 
order by status.sortOrder 


如 果 我 把 statusChanges 实例 集 映 射 为 一 个 列表 (list) 而 不 是 一 个 集合 (set) , 
书写 查询 语句 将 更 加 简单 . 


select count(payment), status.name 
from Payment as payment 
join payment.currentStatus as status 
where payment.status.name <> PaymentStatus.AWAITING_APPROVAL 
or payment.statusChanges[ maxIndex(payment.statusChanges) ].use 
group by status.name, status.sortOrder 
order by status.sortOrder 


和 SS See 





下 面 一 个 查询 使 用 了 MS SQL Server) isNull() BAAR EL 4AA > R2 
织 的 组 织 帐 号 及 组 织 未 支付 的 账 。 它 被 转换 成 一 个 对 表 ACCOUNT , PAYMENT , 
PAYMENT_STATUS ， ACCOUNT_TYPE , ORGANIZATION 以 及 ORG_USER 进行 的 
三 个 内 连接 ， 一 个 外 连接 和 一 个 子 选 择 的 SQL 查询 。 


select account, payment 
from Account as account 
left outer join account.payments as payment 
where :currentUser in elements(account.holder.users) 
and PaymentStatus.UNPAID = isNull(payment.currentStatus.name, Ff 
order by account.type.sortOrder, account.accountNumber, payment. due 
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对 于 一 些 数 据 库 ， 我 们 需要 奔 用 (相关 的 ) 子 选择 。 


select account, payment 
from Account as account 
join account.holder.users as user 
left outer join account.payments as payment 
where :currentUser = user 
and PaymentStatus.UNPAID = isNull(payment.currentStatus.name, Ff 
order by account.type.sortOrder, account.accountNumber, payment. due 
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14.14. 批量 的 UPDATE 和 DELETE 


HQL 现 在 支持 update, delete 和 insert ... select .. .语句 .查阅 第 
13.4 节 “DML( 数 据 操作 语言 ) 风 格 的 操作 (DML-style operations)” 以 获得 更 多 信息 。 


14.15. 小 技巧 & 小 窍门 
你 可 以 统计 查询 结果 的 数目 而 不 必 实际 的 返回 他 们 : 


( (Integer) session.iterate("select count(*) from ....").next() ).: 
‘ aaa 
若 想 根据 一 个 集合 的 大 小 来 进行 排序 ， 可 以 使 用 如 下 的 语句 : 








select usr.id, usr.name 
from User as usr 
left join usr.messages as msg 
group by usr.id, usr.name 
order by count(msg) 


如 果 你 的 数据 库 支 持 子 选择 ， 你 可 以 在 你 的 查询 的 where 子 句 中 为 选择 的 大 小 


(selection size) 指定 一 个 条 件 : 


from User usr where size(usr.messages) >= 1 


AERA ERSTE, HA RMA ig : 


select usr.id, usr.name 
from User usr.name 

join usr.messages msg 
group by usr.id, usr.name 
having count(msg) >= 1 


因为 内 连接 (inner join) 的 原因 ， 这 个 解决 方案 不 能 返回 含有 需 个 信息 的 User 
类 的 实例 , 所 以 这 种 情况 下 使 用 下 面 的 格式 将 是 有 帮助 的 : 


select usr.id, usr.name 
from User as usr 
left join usr.messages as msg 
group by usr.id, usr.name 
having count(msg) = 0 


JavaBean 的 属性 可 以 被 缚 定 到 一 个 命名 查询 (named query) 的 参数 上 : 


Query q = s.createQuery("from foo Foo as foo where foo.name=:name : 
q.setProperties(fooBean); // fooBean 包 含 方法 getName( )SgetSize() 
List foos = q.list(); 
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通过 将 接口 query 与 一 个 过 滤器 (iter) 一 起 使 用 ， 集 合 (Collections) 是 可 以 
分 页 的 : 








Query q = s.createFilter( collection, "" ); // 一 个 简单 的 过 滤器 
q.setMaxResults(PAGE_SIZE); 

q.setFirstResult(PAGE_SIZE * pageNumber); 

List page = q.list(); 


通过 使 用 查询 过 滤器 (query filter) ALYSSA (Collection) 的 原 素 分 组 或 排序 : 


Collection orderedCollection = s.filter( collection, "order by thi: 
Collection counts = s.filter( collection, "select this.type, counti 
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不 用 通过 初始 化 ， 你 就 可 以 知道 一 个 集合 (Collection) 的 大 小 : 





( (Integer) session.iterate("select count(*) from ....").next() ).: 
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15 章 条 件 查 询 (Criteria Queries) 


15.1. 创建 一 个 criteria 实例 

15.2. 限制 结果 集 内 容 

15.3. 结果 集 排序 

15.4. 关联 

15.5. 动态 关联 抓 取 

15.6. 查询 示例 

15.7. 投影 (Projections)、 聚 合 (aggregation) 和 分 组 (grouping) 
15.8. 离线 (detached) 查 询 和 子 查询 

15.9. 根据 自然 标识 查询 (Queries by natural identifier) 


一 个 直观 的 、 可 扩展 的 条 件 查 询 API 是 Hibernate 的 特色 。 


15.1. 创建 一 个 Criteria 实例 


org.hibernate.Criteria 接口 表示 特定 持久 类 的 一 个 查询 。 Session 是 
Criteria 实例 的 工厂 。 


Criteria crit = sess.createCriteria(Cat.class); 
crit.setMaxResults(50); 
List cats = crite list): 


15.2. 限制 结果 集 内 容 


一 个 单独 的 查询 条 件 是 org.hibernate.criterion.Criterion 接口 的 一 个 实 
例 。 org.hibernate.criterion.Restrictions 类 定义 了 获得 某 些 内 
i@ Criterion 类 型 的 工厂 方法 。 


List cats = sess.createCriteria(Cat.class) 
.add( Restrictions.like("name", "Fritz%") ) 
.add( Restrictions.between("weight", minWeight, maxWeight) ) 
.list(); 
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List cats = sess.createCriteria(Cat.class) 
.add( Restrictions.like("name", "Fritz%") ) 
.add( Restrictions.or( 
Restrictions.eq( "age", new Integer(0) ), 
Restrictions.isNull("age") 


) ) 
.list(); 


List cats = sess.createCriteria(Cat.class) 
.add( Restrictions.in( "name", new String[] { "Fritz", "Izi", ' 
.add( Restrictions.disjunction() 
.add( Restrictions.isNull("age") ) 
.add( Restrictions.eq("age", new Integer(@) ) ) 
.add( Restrictions.eq("age", new Integer(1) ) ) 
.add( Restrictions.eq("age", new Integer(2) ) ) 





Hibernate 提 供 了 相当 多 的 内 置 criterion 类 型 ( Restrictions 子 类 ), 但 是 尤其 有 用 
的 是 可 以 允许 你 直接 使 用 SQL。 


List cats = sess.createCriteria(Cat.class) 
.add( Restrictions.sqlRestriction("lower({alias}.name) like lov 
Lust) 





{alias} 占 位 符 应 当 被 蔡 换 为 被 查询 实体 的 列 别名 。 


Property 实例 是 获得 一 个 条 件 的 另外 一 种 途径 。 你 可 以 通过 调 
用 Property.forName() 创建 一 个 Property 。 


Property age = Property.forName("age"); 
List cats = sess.createCriteria(Cat.class) 
.add( Restrictions.disjunction() 
.add( age.isNull() ) 
.add( age.eq( new Integer(@) ) ) 
.add( age.eq( new Integer(1) ) ) 
.add( age.eq( new Integer(2) ) ) 
) ) 
.add( Property.forName("name").in( new String[] { "Fritz", "Iz: 
ITS EQ) 
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15.3. 结果 集 排 序 
你 可 以 使 用 org.hibernate.criterion.Order 来 为 查询 结果 排序 。 


List cats = sess.createCriteria(Cat.class) 
.add( Restrictions.like("name", "F%") 
.addOrder( Order.asc("name") ) 
.addOrder( Order.desc("age") ) 
.setMaxResults(50) 

ESE 


List cats = sess.createCriteria(Cat.class) 
.add( Property.forName("name").like("F%") ) 
.addOrder( Property.forName("name").asc() ) 
.addOrder( Property.forName("age").desc() ) 
.setMaxResults(50) 

SUSE) s 


15.4. 天 联 
你 可 以 使 用 createcriteria() 非常 容易 的 在 互相 关联 的 实体 间 建 立 约束 。 


List cats = sess.createCriteria(Cat.class) 
.add( Restrictions.like("name", "F%") ) 
.createCriteria("kittens") 

.add( Restrictions.like("name", "F%") ) 
eS EE) 


注意 第 二 个 createcriteria() 返回 一 个 新 的 criteria 实例 ， 该 实例 引 
用 kittens 集合 中 的 元 素 。 


接 下 来 ， 蔡 换 形态 在 某 些 情况 下 也 是 很 有 用 的 。 


List cats = sess.createCriteria(Cat.class) 
.createAlias("kittens", "kt") 
.createAlias("mate", "mt") 
.add( Restrictions.eqProperty("kt.name", "mt.name") ) 
TSE Os 


( createAlias() 并 不 创建 一 个 新 的 Criteria 实例 。) 


cat 实例 所 保存 的 之 前 两 次 查询 所 返回 的 kittens 集 合 是 没有 被 条 件 预 过 滤 的 。 如 
果 你 希望 只 获得 符合 条 件 的 kittens， 你 必须 使 用 ResultTransformer 。 


List cats = sess.createCriteria(Cat.class) 
.createCriteria("kittens", "kt") 

.add( Restrictions.eq("name", "F%") ) 
.setResultTransformer(Criteria.ALIAS TO _ENTITY_MAP) 
lk St lee 

Iterator iter = cats.iterator(); 

while ( iter.hasNext() ) { 
Map map = (Map) iter.next(); 
Cat cat = (Cat) map.get(Criteria.ROOT_ALIAS); 
Cat kitten = (Cat) map.get("kt"); 


15.5. 动态 关联 抓 取 
你 可 以 使 用 setFetchMode() 在 运行 时 定义 动态 关联 抓 取 的 语义 。 


List cats = sess.createCriteria(Cat.class) 
.add( Restrictions.like("name", "Fritz%") ) 
.setFetchMode("mate", FetchMode.EAGER) 
.setFetchMode("kittens", FetchMode.EAGER) 
.list(); 


这 个 查询 可 以 通过 外 连接 抓 取 mate 和 kittens. 查看 第 19.1 7 “MAK 


(Fetching strategies) "可 以 获得 更 多 信息 。 


15.6. 


查询 示例 


org.hibernate.criterion.Example 类 人 允许 你 通过 一 个 给 定 实例 构建 一 个 条 件 


查询 。 


Cat cat = new Cat(); 
cat.setSex('F'); 
cat.setColor(Color.BLACK); 


List 


results = session.createCriteria(Cat.class) 


.add( Example.create(cat) ) 
last) 


版 本 属性 、 标 识 符 和 关联 被 忽略 。 黑 认 情 况 下 值 为 null 的 属性 将 被 排除 。 
你 可 以 自行 调整 Example 使 之 更 实用 。 


Example example = Example.create(cat) 


List 


.excludeZeroes() //exclude zero valued properties 
.excludeProperty("color") //exclude the property named "color' 
. ignoreCase() //perform case insensitive string cc 
.enableLike(); //use like for string comparisons 
results = session.createCriteria(Cat.class) 

.add(example ) 


.list(); 


Ki 一 





你 甚至 可 以 使 用 examples 在 关联 对 象 上 放置 条 件 。 


List results = session.createCriteria(Cat.class) 


.add( Example.create(cat) ) 
.createCriteria("mate") 


.add( Example.create( cat.getMate() ) ) 


list(); 


15.7. 投影 (Projections)、 有 聚合 (aggregation) 和 
分 组 (grouping) 


org.hibernate.criterion.Projections 是 Projection 的 实例 工厂 。 我 们 
通过 调用 setProjection() 应 用 投影 到 一 个 查询 。 


List results = session.createCriteria(Cat.class) 
.setProjection( Projections.rowCount() ) 
.add( Restrictions.eq("color", Color.BLACK) ) 
Mast O 


List results = session.createCriteria(Cat.class) 
.setProjection( Projections.projectionList() 
.add( Projections.rowCount() ) 
.add( Projections.avg("weight") ) 
.add( Projections.max("weight") ) 
.add( Projections.groupProperty("color") ) 


) 


.1ist (); 
在 一 个 条 件 查 询 中 没有 必要 显 式 的 使 用 "group by" 。 某 些 投 影 类 型 就 是 被 定义 为 
分 组 投影 ， 他 们 也 出 现在 SQL 的 group by 子 句 中 。 
你 可 以 选择 把 一 个 别名 指派 给 一 个 投影 ， 这 样 可 以 使 投影 值 被 约束 或 排序 所 引用 。 
下 面 是 两 种 不 同 的 实现 方式 : 


List results = session.createCriteria(Cat.class) 
.setProjection( Projections.alias( Projections. groupProperty('"¢ 
.addOrder( Order.asc("colr") ) 
.list(); 
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List results = session.createCriteria(Cat.class) 
.setProjection( Projections.groupProperty("color").as("colr") 
.addOrder( Order.asc("colr") ) 
ESEO 
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alias() 和 as() 方法 简便 的 将 一 个 投影 实例 包装 到 另外 一 个 别名 
的 Projection 实例 中 。 简 而 言 之 ， 当 你 添加 一 个 投 时 多 到 一 个 投影 列表 中 时 你 可 
以 为 它 指定 一 个 别名 : 


List 


List 


results = session.createCriteria(Cat.class) 
.setProjection( Projections.projectionList() 
.add( Projections.rowCount(), "catCountByColor" ) 
.add( Projections.avg("weight"), "avgWeight" ) 
.add( Projections.max("weight"), "maxWeight" ) 
.add( Projections.groupProperty("color"), "color" ) 


) 


.addOrder( Order.desc("catCountByColor") ) 
.addOrder( Order.desc("avgWeight") ) 
SEO 


results = session.createCriteria(Domestic.class, "cat") 
.createAlias("kittens", "kit") 
.setProjection( Projections.projectionList() 
.add( Projections.property("cat.name"), "catName" ) 
.add( Projections.property("kit.name"), "kitName" ) 


.addOrder( Order.asc("catName") ) 
.addOrder( Order.asc("kitName") ) 
TSE OF 


你 也 可 以 使 用 Property.forname() 来 表示 投影 : 


List 


List 


results = session.createCriteria(Cat.class) 
.setProjection( Property.forName("name") ) 

.add( Property.forName("color").eq(Color.BLACK) ) 
ellen Moye pal hea 


results = session.createCriteria(Cat.class) 

.setProjection( Projections.projectionList() 
.add( Projections.rowCount().as("catCountByColor") ) 
.add( Property.forName("weight").avg().as("avgWeight") ) 
.add( Property.forName("weight").max().as("maxWeight") ) 
.add( Property.forName("color").group().as("color" ) 

) 

.addOrder( Order.desc("catCountByColor") ) 

.addOrder( Order.desc("avgWeight") ) 

SES Ty 


15.8. 离线 (detached) 查 询 和 子 查询 


Detachedcriteria 类 使 你 在 一 个 session 范 围 之 外 创建 一 个 查询 ， 并 且 可 以 使 用 
任意 的 Session 来 执行 它 。 


DetachedCriteria query = DetachedCriteria.forClass(Cat.class) 
.add( Property.forName("sex").eq('F') ); 


Session session = ....; 
Transaction txn = session.beginTransaction(); 


List results = query.getExecutableCriteria(session).setMaxResults(: 
txn.commit(); 
session.close(); 


Se em 





DetachedCriteria 也 可 以 用 以 表示 子 查询 。 条 件 实 例 包 含 子 查 询 可 以 通过 
Subqueries 或 者 Property 获得 。 


DetachedCriteria avgWeight = DetachedCriteria.forClass(Cat.class) 
.setProjection( Property. forName("weight").avg() ); 
session.createCriteria(Cat.class) 
.add( Property.forName("weight).gt(avgweight) ) 
.list(); 


Oe ae | 


DetachedCriteria weights = DetachedCriteria.forClass(Cat.class) 
.setProjection( Property.forName("weight") ); 
session.createCriteria(Cat.class) 
.add( Subqueries.geAll("weight", weights) ) 
.list(); 


甚至 相互 关联 的 子 查 询 也 是 有 可 能 的 : 


DetachedCriteria avgweightForSex = DetachedCriteria.forClass(Cat.c- 
.setProjection( Property.forName("weight").avg() ) 
.add( Property.forName("cat2.sex").eqProperty("cat.sex") ); 
session.createCriteria(Cat.class, "cat") 


.add( Property.forName("weight).gt(avgweightForSex) ) 
last); 


: as 








15.9. 根据 自然 标识 查询 (Queries by natural 
identifier) 


对 大 多 数 查 询 ， 包 括 条 件 查 询 而 言 ， 因 为 查询 缓存 的 失效 (invalidation) 发 生得 太 频 
繁 ， 查 询 缓存 不 是 非常 高 效 。 然 而 ， 有 一 种 特别 的 查询 ， 可 以 通过 不 变 的 自然 键 优 
化 缓存 的 失效 算法 。 在 某 些 应 用 中 ， 这 种 类 型 的 查询 比较 常见 。 条 件 查 询 API 对 这 
种 用 例 提 供 了 特别 规约 。 


首先 ， 你 应 该 对 你 的 entity 使 用 alt;natural-id&gt; 来 映射 自然 键 ， 然 后 打开 第 
二 级 缓存 。 


<class name="User"> 
<cache usage="read-write"/> 
<id name="id"> 
<generator class="increment"/> 
</id> 
<natural-id> 
<property name="name"/> 
<property name="org"/> 
</natural-id> 
<property name="password"/> 
</class> 


注意 ,此 功能 对 具有 mutable 自 然 键 的 entity 并 不 适用 。 
然后 ， 打 开 Hibernate 查询 缓存 。 
现在 ， 我 们 可 以 用 Restrictions.naturalid() 来 使 用 更 加 高 效 的 缓存 算法 。 


session.createCriteria(User.class) 
.add( Restrictions.naturallId() 
.set("name", "gavin") 
.set("org", "hb") 
).setCacheable(true) 
.uniqueResult(); 
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16.1.1. 标量 查询 (Scalar queries) 

16.1.2. 实体 查询 (Entity queries) 

16.1.3. 义理 关联 和 集合 类 (Handling associations and collections) 
16.1.4. 返回 多 个 实体 (Returning multiple entities) 

16.1.5. 返回 非 受 管 实体 (Returning non-managed entities) 

16.1.6. 处 理 继承 (Handling inheritance) 

16.1.7. 参数 (Parameters) 


e 16.2. 命名 SQL 查 询 
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16.2.1. 使 用 return-property 来 明确 地 指定 字段 /别名 
16.2.2. 使 用 存储 过 程 来 查询 


e 16.3. 定制 SQL 用 来 create，update 和 delete 
。 16.4. 定制 装载 SQL 


你 也 可 以 使 用 你 的 数据 库 的 Native SQL 话 言 来 查询 数据 。 这 对 你 在 要 使 用 数据 库 的 
某 些 特性 的 时 候 ( 比 如 说 在 查询 提示 或 者 Oracle 中 的 CONNECT 关键 字 )， 这 是 非常 
有 用 的 。 这 就 能 够 扫 清 你 把 原来 直接 使 用 SQL/JDBC 的 程序 迁移 到 基于 Hibernate 
应 用 的 道路 上 的 障碍 。 


Hibernate3 人 允许 你 使 用 手写 的 sq| 来 完成 所 有 的 create,update,delete, 和 Iload 操 作 
(包括 存储 过 程 ) 


16.1. 使 用 SQLQuery 


对 原生 SQL 查询 执行 的 控制 是 通过 SQLQuery 接口 进行 的 ， 通 过 执 
{T Session.createSQLQuery() 获取 这 个 接口 。 下 面 来 描述 如 何 使 用 这 个 API 进 
行 查询 。 


16.1.1. 标量 查询 (Scalar queries) 
最 基本 的 SQL 查 询 就 是 获得 一 个 标量 (数值 ) 的 列表 。 
sess.createSQLQuery("SELECT * FROM CATS").list(); 


sess.createSQLQuery("SELECT ID, NAME, BIRTHDATE FROM CATS").1ist(). 
‘| = a 





它们 都 将 返回 一 个 Object 数 组 (Object[]) 组 成 的 List， 数 组 每 个 元 素 都 是 CATS 表 的 一 
个 字段 值 。Hibernate 会 使 用 ResultSetMetadata 来 判定 返回 的 标量 值 的 实际 顺序 和 
如 果 要 避免 过 多 的 使 用 ResultSetMetadata ,或 者 只 是 为 了 更 加 明确 的 指名 返回 

值 ， 可 以 使 用 addscalar() 。 


sess.createSQLQuery("SELECT * FROM CATS") 
.addScalar("ID", Hibernate. LONG) 
.addScalar ( "NAME", Hibernate.STRING) 
.addScalar ( "BIRTHDATE", Hibernate .DATE) 


这 个 查询 指定 了 : 

e。 SQL 查询 字符 串 

e 要 返回 的 字段 和 类 型 
它 仍然 会 返回 Object 数组 ,但 是 此 时 不 再 使 用 ResultSetMetdata ,而 是 明确 的 将 
ID,NAME 和 BIRTHDATE 按 照 Long,String 和 Short 类 型 从 resultset 中 取出 。 同 时 ， 也 
指明 了 就 算 query 是 使 用 * 来 查询 的 ， 可 能 获得 超过 列 出 的 这 三 个 字段 ， 也 仅仅 会 
返回 这 三 个 字段 。 


对 全 部 或 者 部 分 的 标量 值 不 设置 类 型 信息 也 是 可 以 的 。 


sess.createSQLQuery("SELECT * FROM CATS") 
.addScalar("ID", Hibernate. LONG) 
.addScalar ( "NAME" ) 
.addScalar ("BIRTHDATE") 


基本 上 这 和 前 面 一 个 查询 相同 ,只 是 此 时 使 用 ResultSetMetaData 来 决定 NAME 和 
BIRTHDATE 的 类 型 ， 而 ID 的 类 型 是 明确 指出 的 。 


关于 从 ResultSetMetaData 返 回 的 java.sql.Types 是 如 何 映 射 到 Hibernate 类 型 ， 是 由 
方言 (Dialect) 控 制 的 。 假 若 某 个 指定 的 类 型 没有 被 映射 ， 或 者 不 是 你 所 预期 的 类 
型 ， 你 可 以 通过 Dialet 的 registerHibernateType 调用 自行 定义 。 


16.1.2. 实体 查询 (Entity queries) 


上 面 的 查询 都 是 返回 标量 值 的 ， 也 就 是 从 resultset 中 返回 的 “ 裸 " 数 据 。 下 面 展示 如 
何 通过 addEntity() 让 原生 查询 返回 实体 对 象 。 


sess.createSQLQuery("SELECT * FROM CATS").addEntity(Cat.class); 

sess.createSQLQuery("SELECT ID, NAME, BIRTHDATE FROM CATS") .addEnt: 
‘ SSS 
这 个 查询 指定 : 

。 SOLA WFR 

。 要 返回 的 实体 


假设 Cat 被 映射 为 拥有 ID,NAME 和 BIRTHDATE 三 个 字段 的 类 ， 以 上 的 两 个 查询 都 返 
回 一 个 List， 每 个 元 素 都 是 一 个 Cat 实 体 。 


假若 实体 在 映射 时 有 一 个 many-to-one 的 关联 指向 另外 一 个 实体 ， 在 查询 时 必须 
也 返回 那个 实体 ， 否 则 会 导致 发 生 一 个 "column not found" 的 数据 库 错 误 。 这 些 附加 
的 字段 可 以 使 用 * 标 注 来 自动 返回 ， 但 我 们 希望 还 是 明确 指明 ， 看 下 面 这 个 具有 指 

向 Dog 的 many-to-one 的 例子 : 








sess.createSQLQuery("SELECT ID, NAME, BIRTHDATE, DOG_ID FROM CATS": 


这 样 cat.getDog() 就 能 正常 运作 。 





16.1.3. 处 理 关 联 和 集合 类 (Handling associations 
and collections) 


通过 提前 抓 取 将 Dog 连接 获得 ， 而 避免 初始 化 proxy 带 来 的 额外 开销 也 是 可 能 的 。 
这 是 通过 addJoin() 方法 进行 的 ， 这 个 方法 可 以 让 你 将 关联 或 集合 连接 进来 。 


sess.createSQLQuery("SELECT c.ID, NAME, BIRTHDATE, DOG_ID, D_ID, D_ 
.addEntity( "cat", Cat.class) 
.addJoin("cat.dog"); 


a =: 





上 面 这 个 例子 中 ， 返 回 的 cat 对 象 ， 其 dog 属性 被 完全 初始 化 了 ， 不 再 需要 数据 
库 的 额外 操作 。 注 意 ， 我 们 加 了 一 个 别名 ("cat")， 以 便 指明 join 的 目标 属性 路 径 。 通 
过 同样 的 提前 连接 也 可 以 作用 于 集合 类 ， 例 如 ， 假 若 cat 有 一 个 指向 Dog 的 一 对 
多 关联 。 


sess.createSQLQuery("SELECT ID, NAME, BIRTHDATE, D_ID, D_NAME, CAT. 
.addEntity("cat", Cat.class) 
.addJoin("cat.dogs"); 





到 此 为 止 ， 我 们 碰 到 了 天 花 板 : 若 不 对 SQL 查询 进行 增强 ， 这 些 已 经 是 在 Hibernate 


中 使 用 原生 SQL 查 询 所 能 做 到 的 最 大 可 能 了 。 下 面 的 问题 即将 出 现 : 返回 多 个 同样 
类 型 的 实体 怎么 办 ?或 者 默认 的 别名 /字段 不 够 又 怎么 办 ? 


16.1.4. 返回 多 个 实体 (Returning multiple 

entities) 

到 目前 为 止 ,结果 集 字 段 名 被 假定 为 和 映射 文件 中 指定 的 的 字段 名 是 一 致 的 。 假 若 

SQL 查询 连接 了 多 个 表 ， 同 一 个 字段 名 可 能 在 多 个 表 中 出 现 多 次 ， 这 就 会 造成 问 

题 。 

下 面 的 查询 中 需要 使 用 字段 别名 注射 (这 个 例子 本 身 会 失败 ) 
sess.createSQLQuery("SELECT c.*, m.* FROM CATS c, CATS m WHERE c.) 


.addEntity( "cat", Cat.class) 
.addEntity("mother", Cat.class) 


E 





这 个 查询 的 本 意 是 希望 每 行 返回 两 个 Cat 实 例 ， 一 个 是 cat, 另 一 个 是 它 的 妈妈 。 但 是 
因为 它们 的 字段 名 被 映射 为 相同 的 ， 而 且 在 某 些 数 据 库 中 ， 返 回 的 字段 别名 

是 “c.ID”,"c.NAME" 这 样 的 形式 ， 而 它们 和 在 映射 文件 中 的 名 字 ("ID" 和 "NAME") 
不 匹配 ， 这 就 会 造成 失败 。 


下 面 的 形式 可 以 解决 字段 名 重复 : 
sess.createSQLQuery("SELECT {cat.*}, {mother.*} FROM CATS c, CATS 
.addEntity("cat", Cat.class) 
.addEntity("mother", Cat.class) 
| _ #8 
这 个 查询 指明 : 
。 SQL 坦 询 语句 ， 其 中 包含 占 位 附 来 让 Hibernate 注 射 字段 别名 
o 查询 返回 的 实体 


上 面 使 用 的 {cat2 和 {mother.} 标 记 是 作为 “所 有 属性 "的 简写 形式 出 现 的 。 当 然 你 也 可 
以 明确 地 罗列 出 字段 名 ， 但 在 这 个 例子 里 面 我 们 让 Hibernate 来 为 每 个 属性 注射 SQL 
字段 别名 。 字 段 别名 的 占 位 符 是 属性 名 加 上 表 别 名 的 前 级 。 在 下 面 的 例子 中 ， 我 们 
从 另外 一 个 表 (cat_log) 中 通过 映射 元 数据 中 的 指定 获取 Cat 和 它 的 妈妈 。 注 意 ， 
要 是 我 们 愿意 ， 我 们 甚至 可 以 在 where 子 句 中 使 用 属性 别名 。 





String sql = "SELECT ID as {c.id}, NAME as {c.name}, " + 
"BIRTHDATE as {c.birthDate}, MOTHER_ID as {c.mother}, {mot 
"FROM CAT_LOG c, CAT_LOG m WHERE {c.mother} = c.ID"; 


List loggedCats = sess.createSQLQuery(sql) 
.addEntity("cat", Cat.class) 
.addEntity("mother", Cat.class).list() 


— _# 








16.1.4.1. 别名 和 属性 引用 (Alias and property 
references) 
大 多 数 情况 下 ， 都 需要 上 面 的 属性 注射 ， 但 在 使 用 更 加 复 订 的 映射 ， 比 如 复合 属 


性 、 通 过 标识 符 构 造 继承 树 ， 以 及 集合 类 等 等 情况 下 ， 也 有 一 些 特别 的 别名 ， 来 允 
许 Hibernate 注 射 合适 的 别名 。 


下 表 列 出 了 使 用 别名 注射 参数 的 不 同 可 能 性 。 注 意 : 下 面 结果 中 的 别名 只 是 示例 ， 
实用 时 每 个 别名 需要 唯一 并 且 不 同 的 名 字 。 


表 16.1. 别名 注射 (alias injection names) 


描述 语法 
简单 属性 {[aliasname]. [propertyname] AN 
复合 属性 {[aliasname].[componentname].[propertyname ] } CUF 
实体 辨别 器 
(Discriminator {[aliasname].class} DIS 
of an entity) 
ae {[aliasname].*} fost 
合 键 
(collection {[aliasname] . key} ORC 
key) 
Bid {[aliasname].id} EMF 
AIL {[aliasname] .element} XI[ 
as {[aliasname].element.[propertyname ] } NAN 
a {[aliasname].element.*} {cc 
TEE {[aliasname].*} {cc 


16.1.5. 返回 非 受 管 实体 (Returning non-managed 
entities) 
可 以 对 原生 sql 查询 使 用 ResultTransformer。 这 会 返回 不 受 Hibernate 管 理 的 实体 。 


sess.createSQLQuery("SELECT NAME, BIRTHDATE FROM CATS") 
. setResultTransformer(Transformers.aliasToBean(CatDTO.clas: 


»| 





al 





这 个 查询 指定 : 
e。 SALE HFE 
e 结果 转换 器 (result transformer) 


上 面 的 查询 将 会 返回 catDTO 的 列表 , 它 将 被 实例 化 并 且 将 NAME 和 BIRTHDAY 的 值 
注射 入 对 应 的 属性 或 者 字段 。 


16.1.6. 处 理 继承 (Handling inheritance) 


原生 SQL 查 询 假若 其 查询 结果 实体 是 继承 树 中 的 一 部 分 ， 它 必须 包含 基 类 和 所 有 子 
类 的 所 有 属性 。 


16.1.7. 参数 (Parameters) 
原生 坦 询 支持 位 置 参数 和 命名 参数 : 


Query query = sess.createSQLQuery("SELECT * FROM CATS WHERE NAME 1: 
List pusList = query.setString(0, "Pus%").list(); 


query = sess.createSQLQuery("SELECT * FROM CATS WHERE NAME like :ni 
List pusList = query.setString("name", "Pus%").list(); 


i op 





16.2. 命名 SQL 查询 


可 以 在 映射 文档 中 定义 查询 的 名 字 , 然 后 就 可 以 象 调 用 一 个 命名 的 HQL 查 询 一 样 直 接 
调用 命名 SQL 查询 .在 这 种 情况 下 ,我 们 不 需要 调用 addEntity() 方法 . 


<sql-query name="persons"> 
<return alias="person" class="eg.Person"/> 
SELECT person.NAME AS {person.name}, 
person.AGE AS {person.age}, 
person.SEX AS {person.sex} 
FROM PERSON person 
WHERE person.NAME LIKE :namePattern 
</sql-query> 


List people = sess.getNamedQuery("persons" ) 
.setString("namePattern", namePattern) 
.setMaxResults(50) 

TESEO 


&lt;return-join&gt; 和 &lt;load-collectionggt; 元 素 是 用 来 连接 关联 以 
及 将 查询 定义 为 预先 初始 化 各 个 集合 的 。 


<sql-query name="personsWith"> 
<return alias="person" class="eg.Person"/> 
<return-join alias="address" property="person.mailingAddress"/: 
SELECT person.NAME AS {person.name}, 
person.AGE AS {person.age}, 
person.SEX AS {person.sex}, 
adddress.STREET AS {address.street}, 
adddress.CITY AS {address.city}, 
adddress.STATE AS {address.state}, 
adddress.ZIP AS {address.zip} 
FROM PERSON person 
JOIN ADDRESS adddress 
ON person.ID = address.PERSON_ID AND address. TYPE='MAILING 
WHERE person.NAME LIKE :namePattern 
</sql-query> 


二 = = A 


一 个 命名 查询 可 能 会 返回 一 个 标量 值 .你 必须 使 用 &lt;return-scalar&gt; 元 素 
来 指定 字段 的 别名 和 Hibernate 类 型 


<sql-query name="mySqlQuery"> 
<return-scalar column="name" type="string"/> 
<return-scalar column="age" type="long"/> 
SELECT p.NAME AS name, 
p.AGE AS age, 
FROM PERSON p WHERE p.NAME LIKE 'Hiber%' 
</sql-query> 


你 可 以 把 结果 集 映 射 的 信息 放 在 外 部 的 @lt;resultsetagt; 元 素 中 ， 这 样 就 可 以 
在 多 个 命名 查询 间 ， 或 者 通过 setResultSetMapping() AP| 来 访问 。( 此 处 原文 即 
存疑 。 原 文 为 : You can externalize the resultset mapping informations in a 

&lt;resultset&gt; element to either reuse them accross several named 
queries or through the setResultSetMapping() API.) 


<resultset name="personAddress"> 

<return alias="person" class="eg.Person"/> 

<return-join alias="address" property="person.mailingAddress"/: 
</resultset> 


<sql-query name="personsWith" resultset-ref="personAddress"> 
SELECT person.NAME AS {person.name}, 
person.AGE AS {person.age}, 
person.SEX AS {person.sex}, 
adddress.STREET AS {address.street}, 
adddress.CITY AS {address.city}, 
adddress.STATE AS {address.state}, 
adddress.ZIP AS {address.zip} 
FROM PERSON person 
JOIN ADDRESS adddress 
ON person.ID = address.PERSON_ID AND address. TYPE='MAILING 
WHERE person.NAME LIKE :namePattern 
</sql-query> 


i | 
另外 ,你 可 以 在 java 代 码 中 直接 使 用 hbm 文 件 中 的 结果 集 定 义 信 息 。 





List cats = sess.createSQLQuery( 


) 
.setResultSetMapping("catAndKitten") 
last (); 


"select {cat.*}, {kitten.*} from cats cat, cats kitten whet 





16.2.1. 使 用 return-property 来 明确 地 指定 字段 / 别 
名 


使 用 &lt;return-property&gt; 你 可 以 明确 的 告诉 Hibernate 使 用 哪些 字段 别名 ， 
这 取代 了 使 用 {} -语法 来 让 Hibernate 注 入 它 自己 的 别名 . 


<sql-query name="mySqlQuery"> 
<return alias="person" class="eg.Person"> 
<return-property name="name" column="myName"/> 
<return-property name="age" column="myAge"/> 
<return-property name="sex" column="mySex"/> 
</return> 
SELECT person.NAME AS myName, 
person.AGE AS myAge, 
person.SEX AS mySex, 
FROM PERSON person WHERE person.NAME LIKE :name 
</sql-query> 


<return-property> 也 可 用 于 多 个 字段 , 它 解决 了 使 用 {} -语法 不 能 细 粒 度 控 制 
多 个 字段 的 限制 


<sql-query name="organizationCurrentEmployments"> 
<return alias="emp" class="Employment"> 
<return-property name="Ssalary"> 
<return-column name="VALUE"/> 
<return-column name="CURRENCY"/> 
</return-property> 
<return-property name="endDate" column="myEndDate"/> 
</return> 
SELECT EMPLOYEE AS {emp.employee}, EMPLOYER AS {emp.emy 
STARTDATE AS {emp.startDate}, ENDDATE AS {emp.endDate}, 
REGIONCODE as {emp.regionCode}, EID AS {emp.id}, VALUE, 
FROM EMPLOYMENT 
WHERE EMPLOYER = :id AND ENDDATE IS NULL 
ORDER BY STARTDATE ASC 
</sql-query> 





注意 在 这 个 例子 中 ,我 们 使 用 了 alt;return-propertyagt; 结合 {} 的 注入 语法 . 
人 允许 用 户 来 选择 如 何 引 用 字段 以 及 属性 . 


如 果 你 映射 一 个 识别 器 (discriminator), 你 必须 使 
用 &lt;return-discriminator&gt; 来 指定 识别 器 字段 


16.2.2. 使 用 存储 过 程 来 查询 


Hibernate 3 引入 了 对 存储 过 程 查询 (stored procedure) 和 部 数 (function) 的 支持 .以 下 
的 说 明 中 ， 这 二 者 一 般 都 适用 。 存储 过 程 / 豆 数 必须 返回 一 个 结果 集 , 作 为 Hibernate 
能 够 使 用 的 第 一 个 外 部 参数 . 下 面 是 一 个 Oracle9 和 更 高 版 本 的 存储 过 程 例子 . 


CREATE OR REPLACE FUNCTION selectAllEmployments 
RETURN SYS_REFCURSOR 
AS 
st_cursor SYS _REFCURSOR; 
BEGIN 
OPEN st_cursor FOR 
SELECT EMPLOYEE, EMPLOYER, 
STARTDATE, ENDDATE, 
REGIONCODE, EID, VALUE, CURRENCY 
FROM EMPLOYMENT; 
RETURN st_cursor; 
END; 


在 Hibernate 里 要 要 使 用 这 个 查询 ,你 需要 通过 命名 查询 来 映射 它 . 


<sql-query name="SelectAllEmployees_ SP" callable="true"> 
<return alias="emp" class="Employment"> 
<return-property name="employee" column="EMPLOYEE"/> 
<return-property name="employer" column="EMPLOYER"/> 
<return-property name="startDate" column="STARTDATE"/> 
<return-property name="endDate" column="ENDDATE"/> 
<return-property name="regionCode" column="REGIONCODE"/> 
<return-property name="id" column="EID"/> 
<return-property name="Salary"> 
<return-column name="VALUE"/> 
<return-column name="CURRENCY"/> 
</return-property> 
</return> 
{ ? = call selectAllEmployments() } 
</sql-query> 


a E 


注意 存储 过 程 当 前 仅仅 返回 标量 和 实体 .现在 不 支 
持 &lt;return-join&gt; 和 &1lt;load-collectioné&gt; 





16.2.2.1. 使 用 存储 过 程 的 规则 和 限制 


为 了 在 Hibernate 中 使 用 存储 过 程 ,你 必须 遵循 一 些 规则 .不 遵循 这 些 规则 的 存储 过 程 
将 不 可 用 .如 果 你 仍然 想 要 使 用 他 们 , 你 必须 通过 session.connection() 来 执行 
他 们 .这 些 规则 针对 于 不 同 的 数据 库 .因为 数据 库 提供 商 有 各 种 不 同 的 存储 过 程 语 法 
和 语义 . 

对 存储 过 程 进 行 的 查询 无 法 使 用 setFirstResult()/setMaxResults() 进行 分 

页 。 


建议 采用 的 调用 方式 是 标准 SQL92: 
{ ? = call functionName(&lt;parameters&gt;) } 或 者 
{ ? = call procedureName(&lt;parameters&gt;} .原生 调用 语法 不 被 支持 。 


对 于 Oracle 有 如 下 规则 : 


责 数 必须 返回 一 个 结果 集 。 存 储 过 程 的 第 一 个 参数 必须 是 0UT ， 它 返回 一 个 
” 站 果 集 。 这 是 通过 Oracle 9 或 10 的 SYS_REFCURSOR 类 型 来 完成 的 。 在 Oracle 
中 你 需要 定义 一 个 REF CURSOR 类 型 ， 参 见 Oracle 的 手册 。 


对 于 Sybase 或 者 MS SQL server 有 如 下 规则 : 


e。 存储 过 程 必 须 返 回 一 个 结果 集 。. 注 意 这 些 servers 可 能 返回 多 个 结果 集 以 及 更 
新 的 数目 .Hibernate 将 取出 第 一 条 结果 集 作 为 它 的 返回 值 ， 其 他 将 被 丢弃 。 

e 如 果 你 能 够 在 存储 过 程 里 设 定 SET NOCOUNT ON ， 这 可 能 会 效率 更 高 ， 但 这 
不 是 必需 的 。 


16.3. 定制 SQL 用 来 create，update 和 delete 


Hibernate3 能 够 使 用 定制 的 SQL 语句 来 执行 create,update 和 delete 操 作 。 在 
Hibernate 中 ， 持 久 化 的 类 和 集合 已 经 包含 了 一 套 配 置 期 产生 的 语句 (insertsql， 
deletesql, updatesql 等 等 )， 这 些 映射 标记 &lt;sql-insert&gt; , 
&lt;sql-deleteagt; ,and &lt;sql-updateagt; BRS 这 些 语句 。 


<class name="Person"> 

<id name="id"> 

<generator class="increment"/> 

</id> 

<property name="name" not-null="true"/> 

<sql-insert>INSERT INTO PERSON (NAME, ID) VALUES ( UPPER(?), ? 

<sql-update>UPDATE PERSON SET NAME=UPPER(?) WHERE ID=?</sql-up¢ 

<sql-delete>DELETE FROM PERSON WHERE ID=?</sql-delete> 
</class> 


i ~” R 


这 些 SQL 直 接 在 你 的 数据 库 里 执行 ， 所 以 你 可 以 自由 的 使 用 你 喜欢 的 任意 语法 。 但 
如 果 你 使 用 数据 库 特定 的 语法 ， 这 当然 会 降低 你 映射 的 可 移植 性 。 


如 果 设 定 callable ， 则 能 够 支持 存储 过 程 了 。 





<class name="Person"> 

<id name="id"> 

<generator class="increment"/> 

</id> 

<property name="name" not-null="true"/> 

<sql-insert callable="true">{call createPerson (?, ?)}</sql-ins 

<sql-delete callable="true">{? = call deletePerson (?)}</sql-de 

<sql-update callable="true">{? = call updatePerson (?, ?)}</sq- 
</class> 


Fd  - 
参数 的 位 置 顺序 是 非常 重要 的 ， 他 们 必须 和 Hibernate 所 期 待 的 顺序 相同 。 


你 能 够 通过 设 定 日 志 调 试 级 别 为 org.hiberante.persister.entity ,来 查看 
Hibernate 所 期 待 的 顺序 。 在 这 个 级 别 下 ， Hibernate 将 会 打印 出 create,update 和 
delete 实 体 的 静态 SQL。 (如果 想 看 到 预计 的 顺序 。 记 得 不 要 将 定制 SQL 包 含 在 映射 
文件 里 ， 因为 他 们 会 重 载 Hibernate 生 成 的 静态 SQL。) 


在 大 多 数 情况 下 (最 好 这 么 做 )， 存 储 过 程 需 要 返回 插 和 人 /更 新 /删除 的 行 数 ， 因 为 
Hibernate 对 语句 的 成 功 执 行 有 些 运行 时 的 检查 。 Hibernate 常 会 把 进行 CUD 操 作 的 
语句 的 第 一 个 参数 注册 为 一 个 数值 型 输出 参数 。 





CREATE OR REPLACE FUNCTION updatePerson (uid IN NUMBER, uname IN V/ 
RETURN NUMBER IS 
BEGIN 


update PERSON 
set 

NAME = uname, 
where 

ID = uid; 


return SQL%ROWCOUNT ; 


END updatePerson; 





16.4. 定制 装载 SQL 
你 可 能 需要 声明 你 自己 的 SQL( 或 HQL) 来 装载 实体 


<sql-query name="person"> 


<return alias="pers" class="Person" lock-mode="upgrade"/> 


SELECT NAME AS {pers.name}, ID AS {pers.id} 
FROM PERSON 
WHERE ID=? 
FOR UPDATE 
</sql-query> 


这 只 是 一 个 前 面 讨 论 过 的 命名 查询 声明 ， 你 可 以 在 类 映射 里 引用 这 


<class name="Person"> 
<id name="id"> 
<generator class="increment"/> 
</id> 
<property name="name" not-null="true"/> 
<loader query-ref="person"/> 
</class> 


这 也 可 以 用 于 存储 过 程 
你 甚至 可 以 定 一 个 用 于 集合 装载 的 查询 : 


<set name="employments" inverse="true"> 
<key/> 
<one-to-many class="Employment"/> 
<loader query-ref="employments"/> 
</set> 


<sql-query name="employments"> 


个 命名 查询 。 


<load-collection alias="emp" role="Person.employments"/> 


SELECT {emp.*} 

FROM EMPLOYMENT emp 

WHERE EMPLOYER = :id 

ORDER BY STARTDATE ASC, EMPLOYEE ASC 
</sql-query> 


你 其 至 还 可 以 定义 一 个 实体 装载 器 ， 它 通过 连接 抓 取 装 载 一 个 集合 : 


<sql-query name="person"> 
<return alias="pers" class="Person"/> 
<return-join alias="emp" property="pers.employments"/> 
SELECT NAME AS {pers.*}, {emp.*} 
FROM PERSON pers 
LEFT OUTER JOIN EMPLOYMENT emp 
ON pers.ID = emp.PERSON_ID 
WHERE ID=? 
</sql-query> 
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17.1. Hibernate it 38 45(filters) 


Hibernate3 新 增 了 对 某 个 类 或 者 集合 使 用 预先 定义 的 过 滤器 条 件 (filter criteria) HD 
能 。 过 滤器 条 件 相当 于 定义 一 个 非常 类 似 于 类 和 各 种 集合 上 的 “where” 属 性 的 约束 
子 句 ， 但 是 过 滤器 条 件 可 以 带 参 数 。 应 用 程序 可 以 在 运行 时 决定 是 否 启 用 给 定 的 过 
滤器 ， 以 及 使 用 什么 样 的 参数 值 。 过 滤器 的 用 法 很 像 数据 库 视图 ， 只 不 过 是 在 应 用 
程序 中 确定 使 用 什么 样 的 参数 的 。 


要 使 用 过 滤器 ， 必 须 首先 在 相应 的 映射 节点 中 定义 。 而 定义 一 个 过 滤器 ， 要 用 到 位 
于 &lt;hibernate-mapping/&gt; 节点 之 内 的 &lt;filter-def/&gt; PR: 


<filter-def name="myFilter"> 
<filter-param name="myFilterParam" type="string"/> 
</filter-def> 


定义 好 之 后 ， 就 可 以 在 某 个 类 中 使 用 这 个 过 滤器 : 


<class name="myClass" ...> 


<filter name="myFilter" condition=":myFilterParam = MY_FILTEREI 
</class> 


EE = z 
也 可 以 在 某 个 集合 使 用 它 : 





<Set ...> 
<filter name="myFilter" condition=":myFilterParam = MY_FILTEREI 
</set> 


可 以 在 多 个 类 或 集合 中 使 用 某 个 过 滤器 ; 某 个 类 或 者 集合 中 也 可 以 使 用 多 个 过 滤 
Zito 


Session 对 象 中 会 用 到 的 方法 有 : enableFilter(String filterName) , 
getEnabledFilter(String filterName) ,和 

disableFilter(String filterName) . Session 中 默认 是 不 启用 过 滤器 的 ， 必 须 
通过 Session.enabledFilter() 方法 显 式 的 启用 。 该 方法 返回 被 启用 

的 Filter 的 实例 。 以 上 文 定 义 的 过 滤器 为 例 : 





session.enableFilter("myFilter").setParameter("myFilterParam", "sor 











注意 ，org.hibernate.Filter 的 方法 允许 链 式 方法 调用 。 《类 似 上 面 例子 中 启用 Filter 
之 后 设 定 Filter 参 数 这 个 “方法 链 ”) ” Hibernate 的 其 他 部 分 也 大 多 有 这 个 特性 。 


下 面 是 一 个 比较 完整 的 例子 ， 使 用 了 记录 生效 日 期 模式 过 滤 有 时 效 的 数据 : 


<filter-def name="effectiveDate"> 
<filter-param name="asOfDate" type="date"/> 
</filter-def> 


<class name="Employee" ...> 


<many-to-one name="department" column="dept_id" class="Departme 
<property name="effectiveStartDate" type="date" column="eff_sté 
<property name="effectiveEndDate" type="date" column="eff_end_¢ 


<l-- 
Note that this assumes non-terminal records have an eff_enc 
a max db date for simplicity-sake 


注意 ， 为 了 简单 起 见 ， 此 处 假设 历 用 关系 生效 期 尚未 结束 的 记录 的 eff_end_dt 
m> 
<filter name="effectiveDate" 
condition=":asOfDate BETWEEN eff_start_dt and eff_end_í 
</class> 


<class name="Department" ...> 


<set name="employees" lazy="true"> 
<key column="dept_id"/> 
<one-to-many class="Employee"/> 
<filter name="effectiveDate" 
condition=":asOfDate BETWEEN eff_start_dt and eff 4 
</set> 
</class> 


SSS SSS 


定义 好 后 ， 如 果 想 要 保证 取 回 的 都 是 目前 多 于 生效 期 的 记录 ， 只 需 在 获取 懂 员 数据 
的 操作 之 前 先 开启 过 滤器 即 可 : 





Session session = ...; 
session.enabledFilter("effectiveDate").setParameter("asOfDate", nev 
List results = session.createQuery("from Employee as e where e.salé 
.setLong("targetSalary", new Long(1000000) ) 
Mast 


a] __ ; 
在 上 面 的 HQL 中 ， 虽 然 我们 仅仅 显 式 的 使 用 了 一 个 薪水 条 件 ， 但 因为 启用 了 过 滤 


器 ， 坦 询 将 仅 返 回 那些 目前 展 用 关系 多 于 生效 期 的 ， 并 且 薪 水 高 于 一 百 万 美 刀 的 履 
员 的 数据 。 





注意 : 如 果 你 打算 在 使 用 外 连接 (或 者 通过 HQL 或 load fetching) 的 同时 使 用 过 滤 
器 ， 要 注意 条 件 表 达 式 的 方向 ( 左 还 是 右 ) 。 最 安全 的 方式 是 使 用 左 外 连接 (left 
outer joining) 。 并 且 通 常 来 说 ， 先 写 参 数 ， 然后 是 操作 符 ， 最 后 写 数 据 库 字 段 


o 


在 Filter 定 义 之 后 , 它 可 能 被 附加 到 多 个 实体 和 /或 集合 类 ,每 个 都 有 自己 的 条 件 。 假 若 
这 些 条 件 都 是 一 样 的， 每 次 都 要 定义 就 显得 很 繁 珊 。 因 

Ik, &lt;filter-def/agt; 被 用 来 定义 一 个 默认 条 件 ， 它 可 能 作为 属性 或 者 
CDATA 出 现 : 


<filter-def name="myFilter" condition="abc > xyz">...</filter-def> 
<filter-def name="myOtherFilter">abc=xyz</filter-def> 


二 | 


当 这 个 filter 被 附加 到 任何 目的 地 ， 而 又 没有 指明 条 件 时 ， 这 个 条 件 就 会 被 使 用 。 注 
意 ， 换 句 话 说 ， 你 可 以 通过 给 filter 附 加 特别 的 条 件 来 重 载 默 认 条 件 。 


第 18 章 XML 映射 


目录 


e 18.1. 用 XML 数据 进行 工作 
o 18.1.1. 指定 同时 映射 XML 和 类 
o 18.1.2. 只 定义 XML 了 映射 

e 18.2. XML 映射 元 数据 

e 18.3. 操作 XML 数据 


注意 这 是 Hibernate 3.0 的 一 个 实验 性 的 特性 。 这 一 特性 仍 在 积极 开发 中 。 


18.1. 用 XML 数据 进行 工作 


Hibernate 使 得 你 可 以 用 XML 数据 来 进行 工作 ， 恰 如 你 用 持久 化 的 POJO 进 行 工 作 那 
样 。 解 析 过 的 XML 树 可 以 被 认为 是 代替 POJO 的 另外 一 种 在 对 象 层面 上 表示 关系 型 
数据 的 途径 . 


Hibernate 支 持 采 用 dom4j 作 为 操作 XML 树 的 API。 你 可 以 写 一 些 查询 从 数据 库 中 检 
SRW dom4j 树 ， 随 后 你 对 这 颗 树 做 的 任何 修改 都 将 自动 同步 回 数据 库 。 你 甚至 可 以 
用 dom4j 解 析 一 篇 XML 文档 ， 然 后 使 用 Hibernate 的 任 一 基本 操作 将 它 写 入 数据 库 : 
persist(), saveOrUpdate(), merge(), delete(), replicate() (合并 操作 
merge() 目 前 还 不 支持 )。 


这 一 特性 可 以 应 用 在 很 多 场合 ， 包 括 数据 导入 导出 ， 通 过 JMS 或 SOAP 具 体 化 实体 
数据 以 及 基于 XSLT 的 报表 。 


一 个 单一 的 映射 就 可 以 将 类 的 属性 和 XML 文档 的 节点 同时 映射 到 数据 库 。 如 果 不 需 
要 映射 类 ， 它 也 可 以 用 来 只 映射 XML 文档 。 


18.1.1. 指定 同时 映射 XML 和 类 
这 是 一 个 同时 映射 POJO 和 XML 的 例子 : 


<class name="Account" 
table="ACCOUNTS" 
node="account"> 


<id name="accountId" 
column="ACCOUNT_ID" 
node="@id"/> 


<many-to-one name="Customer" 
column="CUSTOMER_ID" 
node="customer/@id" 
embed -xml="false"/> 


<property name="balance" 
column="BALANCE" 
node="balance"/> 


</class> 


18.1.2. 只 定义 XML 映射 
这 是 一 个 不 映射 POJO 的 例子 : 


<class entity-name="Account" 
table="ACCOUNTS" 
node="account"> 


<id name="id" 
column="ACCOUNT_ID" 
node="@id" 
type="string"/> 


<many-to-one name="CustomerId" 
column="CUSTOMER_ID" 
node="customer/@id" 
embed-xml="false" 
entity-name="Customer"/> 


<property name="balance" 
column="BALANCE" 
node="balance" 
type="big_ decimal"/> 


</class> 


这 个 映射 使 得 你 既 可 以 把 数据 作为 一 棵 dom4j 树 那样 访问 ， 又 可 以 作为 由 属性 键 值 
对 (java Map s) 组 成 的 图 那样 访问 。 属 性 名 字 纯 粹 是 逻辑 上 的 结构 ， 你 可 以 在 HQL 
查询 中 引用 它 。 


18.2. XML 映射 元 数据 
许多 Hibernate 映 射 元 素 具 有 node 属性 。 这 使 你 可 以 指定 用 来 保存 属性 或 实体 数 
据 的 XML 属性 或 元 素 。 node 属性 必须 是 下 列 格式 之 一 : 

e "element-name" - 映射 为 指定 的 XML 元 素 

e "@attribute-name" - 映射 为 指定 的 XML 属性 

o "." -映射 为 父 元 素 

e "element-name/@attribute-name" -映射 为 指定 元 素 的 指定 属性 


对 于 集合 和 单 值 的 关联 ， 有 一 个 额外 的 embed-xml 属性 可 用 。 这 个 属性 的 缺 省 值 
是 真 ( embed-xml="true" )。 如 果 embed-xml="true" , 则 对 应 于 被 关联 实体 或 
值 类 型 的 集合 的 XML 树 将 直接 嵌入 拥有 这 些 关 联 的 实体 的 XML 树 中 。 否则 ， 如 
果 embed-xml="false" ， 那 么 对 于 单 值 的 关联 ， 仅 被 引用 的 实体 的 标识 符 出 现在 
XML 树 中 (被 引用 实体 本 身 不 出 现 )， 而 集合 则 根本 不 出 现 。 


你 应 该 小 心 ， 不 要 让 太 多 关联 的 embed-xml 属 性 为 真 ( embed-xml="true" )， 因 为 
XML 不 能 很 好 地 处 理 循环 引用 |! 


<class name="Customer" 
table="CUSTOMER" 
node="customer"> 


<id name="id" 
column="CUST_ID" 
node="@id"/> 


<map name="accounts" 
node="." 
embed-xml="true"> 
<key column="CUSTOMER_ID" 
not-null="true"/> 
<map-key column="SHORT_DESC" 
node="@short-desc" 
type="string"/> 
<one-to-many entity-name="Account" 
embed-xml="false" 
node="account"/> 
</map> 


<component name="name" 
node="name"> 
<property name="firstName" 
node="first-name"/> 
<property name="initial" 
node="initial"/> 
<property name="lastName" 
node="last-name"/> 
</component> 


</class> 


在 这 个 例子 中 ， 我 们 决定 褒 入 帐 目 号 码 (account id) 的 集合 ， 但 不 嵌入 实际 的 帐 目 数 
据 。 下 面 的 HQL 查 询 : 


from Customer c left join fetch c.accounts where c.lastName like : 
SSS ae 
返回 的 数据 集 将 是 这 样 : 





<customer id="123456789"> 
<account id="987632567" short-desc="Savings"/> 
<account id="985612323" short-desc="Credit Card"/> 
<name> 
<first-name>Gavin</first-name> 
<initial>A</initial> 
<last -name>King</last -name> 
</name> 


</customer> 


如 果 你 把 一 对 多 映射 @lt;one-to-many&gt; 的 embed-xml 属 性 置 为 真 
( embed-xml="true" ) 则 数据 看 上 去 就 像 这 样 : 


<customer id="123456789"> 

<account id="987632567" short-desc="Savings"> 
<customer id="123456789"/> 
<balance>100.29</balance> 

</account> 

<account id="985612323" short-desc="Credit Card"> 
<customer id="123456789"/> 
<balance>-2370.34</balance> 

</account> 

<name> 
<first-name>Gavin</first-name> 
<initial>A</initial> 
<last -name>King</last -name> 

</name> 


</customer> 


18.3. 操作 XML 数 据 


让 我 们 来 读 人 和 更 新 应 用 程序 中 的 XML 文档 。 通 过 获取 一 个 dom4j 会 话 可 以 做 到 这 


AN 


Document doc = ....; 


Session session = factory.openSession(); 
Session dom4jSession = session.getSession(EntityMode.DOM4J); 
Transaction tx = session. beginTransaction(); 


List results = dom4jSession 


.createQuery("from Customer c left join fetch c.accounts where 
lust); 


for ( int i=0; i<results.size(); i++ ) { 


} 


//add the customer data to the XML document 
Element customer = (Element) results.get(i); 
doc.add(customer ); 


tx.commit(); 
session.close(); 


SSS SEE ESS 





Session session = factory.openSession(); 
Session dom4jSession = session.getSession(EntityMode.DOM4J); 
Transaction tx = session.beginTransaction(); 


Element cust = (Element) dom4jSession.get("Customer", customerId); 
for ( int i=0; i<results.size(); i++ ) { 


} 


Element customer = (Element) results.get(i); 
//change the customer name in the XML and database 
Element name = customer.element("name"); 
name.element("first-name").setText(firstName) ; 
name.element("initial").setText(initial); 
name.element("last-name").setText(lastName) ; 


tx.commit(); 
session.close(); 


三 


将 这 一 特色 与 Hibernate 的 replicate() 操作 结合 起 来 对 于 实现 的 基于 XML 的 数据 
导 人 /导出 将 非常 有 用 . 
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19.1. 抓 取 策略 (Fetching strategies) 


抓 取 策略 (fetching strategy) 是 指 : 当 应 用 程序 需要 在 (Hibernate 实体 对 象 图 
的 ) 关联 关系 间 进 行 导航 的 时 候 ， Hibernate 如 何 获取 关联 对 象 的 策略 。 抓 取 策 略 
可 以 在 O/R 映 射 的 元 数据 中 声明 ， 也 可 以 在 特定 的 HQL 

或 条 件 查 询 (Criteria Query) 中 重 载 声明 。 


Hibernate3 定义 了 如 下 几 种 抓 取 策略 : 


e 连接 抓 取 (Join fetching) - Hibernate 通 过 在 SELECT 语句 使 
用 OUTER JOIN (外 连接 ) 来 获得 对 象 的 关联 实例 或 者 关联 集合 。 


查询 抓 取 (Select fetching) - 另外 发 送 一 条 SELECT 语句 抓 取 当前 对 象 的 关 
联 实 体 或 集合 。 除 非 你 显 式 的 指定 lazy="false" 禁止 延迟 抓 取 (lazy 
fetching) ， 否 则 只 有 当 你 真正 访问 关联 天 系 的 时 候 ， 才 会 执行 第 二 条 select 语 


句 。 


子 查询 抓 取 (Subselect fetching) - 另外 发 送 一 条 SELECT 语句 抓 取 在 前 面 
查询 到 (或 者 抓 取 到 ) 的 所 有 实体 对 象 的 关联 集合 。 除 非 你 显 式 的 指 

Œ lazy="false" 禁止 延迟 抓 取 (lazy fetching) ， 否 则 只 有 当 你 真正 访问 关 
联 关 系 的 时 候 ， 才 会 执行 第 二 条 select 语 句 。 


批量 抓 取 (Batch fetching) - 对 查询 抓 取 的 优化 方案 ， 通过 指定 一 个 主键 或 
外 键 列表 ，Hibernate 使 用 单条 SELECT 语句 获取 一 批 对 象 实例 或 集合 。 


Hibernate 会 区 分 下 列 各 种 情况 : 


e Immediate fetching， 立 即 抓 取 - 当 宿 主 被 加 载 时 ， 关 联 、 集 合 或 属性 被 立即 抓 
取 。 


Lazy collection fetching, WER RAM- 直到 应 用 程序 对 集合 进行 了 一 次 操作 
时 ， 集 合 才 被 抓 取 。 〈 对 集合 而 言 这 是 黑 认 行为 。) 


"Extra-lazy" collection fetching, "Extra-lazy" 集 合 抓 取 -对 集合 类 中 的 每 个 元 素 
而 言 ， 都 是 直到 需要 时 才 去 访问 数据 库 。 除 非 绝对 必要 ，Hibernate 不 会 试图 去 
把 整个 集合 都 抓 取 到 内 存 里 来 《适用 于 非常 大 的 集合 ) 。 


Proxy fetching， 代 理 抓 取 - 对 返回 单 值 的 关联 而 言 ， 当 其 某 个 方法 被 调用 ， 而 
非 对 其 关键 字 进 行 get 操 作 时 才 抓 取 。 


"No-proxy" fetching, 非 代理 抓 取 - 对 返回 单 值 的 关联 而 言 ， 当 实例 变量 被 访问 
的 时 候 进 行 抓 取 。 与 上 面 的 代理 抓 取 相 比 ， 这 种 方法 没有 那么 “延迟 "得 厉害 (就 
算 只 访问 标识 符 ， 也 会 导致 关联 抓 取 ) 但 是 更 加 透明 ， 因 为 对 应 用 程序 来 说 ， 不 
再 看 到 proxy。 这 种 方法 需要 在 编译 期 间 进行 字 节 码 增 强 操作 ， 因 此 很 少 需要 用 


到 。 


Lazy attribute jetching， 属 性 延迟 加 载 - 对 属性 或 返回 单 值 的 关联 而 言 ， 当 其 
实例 变量 被 访问 的 时 候 进 行 抓 取 。 需 要 编译 期 字 节 码 强化 ， 因 此 这 一 方法 很 少 
是 必要 的 。 


这 里 有 两 个 正 交 的 概念 : 关联 何 时 被 抓 取 ， 以 及 被 如 何 抓 取 (会 采用 什么 样 的 SQL 
语句 ) 。 不 要 混淆 它们 ! 我 们 使 用 抓 取 来 改善 性 能 。 我 们 使 用 延迟 来 定义 一 些 
契约 ， 对 某 特 定 类 的 某 个 脱 管 的 实例 ， 知 道 有 哪些 数据 是 可 以 使 用 的 。 


19.1.1. 操作 延迟 加 载 的 关联 
默认 情况 下 ，Hibernate 3 对 集合 使 用 延迟 select 抓 取 ， 对 返回 单 值 的 关联 使 用 延迟 
代理 抓 取 。 对 几乎 是 所 有 的 应 用 而 言 ， 其 绝 大 多 数 的 关联 ， 这 种 策略 都 是 有 效 的 。 


注意 :假若 你 设置 了 hibernate.default_batch_fetch_size ,Hibernate 会 对 延迟 
加 载 采 取 批 量 抓 取 优化 措施 〈 这 种 优化 也 可 能 会 在 更 细 化 的 级 别 打 开 ) o 


然而 ， 你 必须 了 解 延 迟 抓 取 带 来 的 一 个 问题 。 在 一 个 打开 的 Hibernate session 上 下 
文 之 外 调用 延迟 集合 会 导致 一 次 意外 。 比 如 : 


s = sessions.openSession(); 
Transaction tx = s.beginTransaction(); 


User u = (User) s.createQuery("from User u where u.name=:userName" 
.setString("userName", userName) .uniqueResult(); 
Map permissions = u.getPermissions(); 


tx.commit(); 
s.close(); 


Integer accessLevel = (Integer) permissions.get("accounts"); // Ei 





在 Session 关闭 后 ，permessions 集 合 将 是 未 实例 化 的 、 不 再 可 用 ， 因 此 无 法 正 
常 载 入 其 状态 。 Hibernate 对 脱 管 对 象 不 支持 延迟 实例 化 . 这 里 的 修改 方法 是 : 将 
permissions 读 取 数 据 的 代码 移 到 tx.commit() 之 前 。 


除 此 之 外 ， 通 过 对 关联 映射 指定 lazy="false" ,我 们 也 可 以 使 用 非 延 迟 的 集合 或 
Kiko BE, 对 绝 大 部 分 集合 来 说 ， 更 推荐 使 用 延迟 方式 抓 取 数 据 。 如 果 在 你 的 对 
象 模型 中 定义 了 太 多 的 非 延 迟 关 联 ，Hibernate 最 终 几 乎 需要 在 每 个 事务 中 载 人 整个 
数据 库 到 内 存 中 ! 


但 是 ， 另 一 方面 ， 在 一 些 特殊 的 事务 中 ， 我 们 也 经 常 需要 使 用 到 连接 抓 取 (CAD 
上 就 是 非 延 迟 的 ) ， 以 代替 查询 抓 取 。 下 面 我 们 将 会 很 快 明 白 如 何 具 体 的 定制 
Hibernate 中 的 抓 取 策略 。 在 Hibernate3 中 ， 具 体 选 择 哪 种 抓 取 策略 的 机 制 是 和 选择 
单 值 关 联 或 集合 关联 相 一 致 的 。 


19.1.2. 调整 抓 取 策 略 (Tuning fetch strategies) 


查询 抓 取 (默认 的 ) 在 N+1 查 询 的 情况 下 是 极其 脆弱 的 ， 因 此 我 们 可 能 会 要 求 在 映 
射 文档 中 定义 使 用 连接 抓 取 : 


<set name="permissions" 
fetch="join"> 
<key column="userId"/> 
<one-to-many class="Permission"/> 
</set 


<many-to-one name="mother" class="Cat" fetch="join"/> 


在 映射 文档 中 定义 的 抓 取 策略 将 会 对 以 下 列表 条 目 产生 影响 : 
。 通 过 get() 或 load() 方法 取得 数据 。 
。 只 有 在 关联 之 间 进 行 导 航 时 ， 才 会 隐 式 的 取得 数据 。 
。 条 件 查 询 
。 使 用 了 subselect 抓 取 的 HQL 查 询 


不 管 你 使 用 哪 种 抓 取 策略 ， 定 义 为 非 延 迟 的 类 图 会 被 保证 一 定 装 载 信 内存。 注意 这 
可 能 意味 着 在 一 条 HQL 查 询 后 紧 跟着 一 系列 的 查询 。 


通常 情况 下 ， 我 们 并 不 使 用 映射 文档 进行 抓 取 策 略 的 定制 。 更 多 的 是 ， 保 持 其 默认 
值 ， 然 后 在 特定 的 事务 中 ， 使 用 HQL 的 左 连接 抓 取 (left join fetch) ”对 其 进 
行 重 载 。 这 将 通知 Hibernate 在 第 一 次 查询 中 使 用 外 部 关联 (outer join) , BRE 
到 其 关联 数据 。 在 条 件 查询 API 中 ， 应 该 调用 
setFetchMode(FetchMode.JOIN) 语句 。 


也 许 你 喜欢 仅仅 通过 条 件 查 询 ， 就 可 以 改变 get() 或 load() 语句 中 的 数据 抓 
取 策 略 。 例 如 : 


User user = (User) session.createCriteria(User.class) 
.setFetchMode("permissions", FetchMode. JOIN) 
.add( Restrictions.idEq(userId) ) 
.uniqueResult(); 


(这 就 是 其 他 ORM 解 决 方案 的 “ 抓 取 计划 (fetch plan)y 在 Hibernate 中 的 等 价 物 。 ) 
截然 不 同 的 一 种 避免 N+1 次 查询 的 方法 是 ， 使 用 二 级 缓存 。 


19.1.3. 单 端 关联 代理 (Single-ended association 
proxies) 


在 Hinerbate 中 ， 对 集合 的 延迟 抓 取 的 采用 了 自己 的 实现 方法 。 但 是 ， 对 于 单 端 关 联 
的 延迟 抓 取 ， 则 需要 采用 其 他 不 同 的 机 制 。 单 端 关联 的 目标 实体 必须 使 用 代理 ， 
Hihernate 在 运行 期 二 进 制 级 (通过 优异 的 CGLIB 库 ) ， 为 持久 对 象 实现 了 延迟 载 
入 代理 。 

默认 的 ，Hibernate3 将 会 为 所 有 的 持久 对 象 产生 代理 〈 在 和 启动 阶段 }) ， 然 后 使 用 他 
们 实现 多 对 一 (many-to-one) 关联 和 一 对 一 (one-to-one) ”关联 的 延迟 抓 
取 。 

在 映射 文件 中 ， 可 以 通过 设置 proxy 属性 为 目标 class 声 明 一 个 接口 供 代理 接口 使 
用 。 默认 的 ，Hibernate 将 会 使 用 该 类 的 一 个 子 类 。 ER: 被 代理 的 类 必须 实现 一 
个 至 少 包 可 见 的 默认 构造 画 数 ， 我 们 建议 所 有 的 持久 类 都 应 拥有 这 样 的 构造 本 数 


在 如 此 方式 定义 一 个 多 态 类 的 时 候 ， 有 许多 值得 注意 的 常见 性 的 问题 ， 例 如 : 


<class name="Cat" proxy="Cat"> 


</subclass> 
</class> 


首先 ， cat 实例 永远 不 可 以 被 强制 转换 为 Domesticcat ,即使 它 本 身 就 


是 Domesticcat 实例 。 


Cat cat = (Cat) session.load(Cat.class, id); // instantiate a pro) 
if ( cat.isDomesticCat() ) { // hit the db to inil 
DomesticCat dc = (DomesticCat) cat; // Error! 


} 
其 次 ， 代 理 的 ”== ”可 能 不 再 成 立 。 





Cat cat = (Cat) session.load(Cat.class, id); // instant: 
DomesticCat dc = 

(DomesticCat) session.load(DomesticCat.class, id); // acd! 
System.out.println(cat==dc); // false 


‘| 








虽然 如 此 ， 但 实际 情况 并 没有 看 上 去 那么 糟糕 。 虽然 我 们 现在 有 两 个 不 同 的 引用 ， 
分 别 指向 这 两 个 不 同 的 代理 对 象 ， 但 实际 上 ， 其 底层 应 该 是 同一 个 实例 对 象 : 


cat.setWeight(11.0); // hit the db to initialize the proxy 
System.out.println( dce.getWeight() ); // 11.0 


第 三 ， 你 不 能 对 “final 类 "或 “具有 final 方 法 的 类 ”使 用 CGLIB 代 理 。 


最 后 ， 如 果 你 的 持久 化 对 象 在 实例 化 时 需要 某 些 资 源 ( 例 如， 在 实例 化 方法 、 默 认 
构造 方法 中 ) ， 那么 代理 对 象 也 同样 需要 使 用 这 些 资源 。 实 际 上 ， 代 理 类 是 持久 化 
类 的 子 类 。 


这 些 问 题 都 源 于 Java 的 单 根 继承 模型 的 天 生 限 制 。 如 果 你 希望 避免 这 些 问题 ， 那 么 
你 的 每 个 持久 化 类 必须 实现 一 个 接口 ， 在 此 接口 中 已 经 声明 了 其 业务 方法 。 然 后 ， 
你 需要 在 映射 文档 中 再 指定 这 些 接口 。 例 如 : 


<class name="CatImpl" proxy="Cat"> 


</subclass> 
</class> 


这 里 CatImpl 实现 了 Cat #O, DomesticCatImpl 实现 DomesticCat 接 
口 。 在 load() 、 iterate() 方法 中 就 会 返回 cat 和 Domesticcat 的 代理 对 
Ro (注意 list() 并 不 会 返回 代理 对 象 。) 


Cat cat = (Cat) session.load(CatImpl.class, catid); 
Iterator iter = session.iterate("from CatImpl as cat where cat.name 
Cat fritz = (Cat) iter.next(); 


这 里 ， 对 象 之 间 的 关系 也 将 被 延迟 载 人 。 这 就 意味 着 ， 你 应 该 将 属性 声明 
为 Cat ， 而 不 是 CatImpl 。 


但 是 ， 在 有 些 方 法 中 是 不 需要 使 用 代理 的 。 例 如 : 
e equals() 方法 ， 如 果 持 久 类 没有 重 载 equals() 方法 。 
e hashCode() 方法 ， 如 果 持 久 类 没有 重 载 hashCode() 方法 。 
e 标志 符 的 getter 方 法 。 
Hibernate 将 会 识别 出 那些 重 载 了 equals() 、 或 hashcode() 方法 的 持久 化 类 。 


若 选择 lazy="no-proxy" 而 非 默认 的 lazy="proxy" ， 我 们 可 以 避免 类 型 转换 
带 来 的 问题 。 然 而 ， 这 样 我 们 就 需要 编译 期 字 节 码 增 强 ， 并 且 所 有 的 操作 都 会 导致 
立刻 进行 代理 初始 化 。 
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19.1.4. 实例 化 集合 和 代理 (Initializing 
collections and proxies) 


在 Session 范围 之 外 访问 未 初始 化 的 集合 或 代理 ，Hibernate 将 会 抛 
出 LazyInitializationException 异常 。 也 就 是 说 ， 在 分 离 状 态 下 ， 访 问 一 个 
实体 所 拥有 的 集合 ， 或 者 访问 其 指向 代理 的 属性 时 ， 会 引发 此 异常 。 


有 时 候 我 们 需要 保证 某 个 代理 或 者 集合 在 Session 关 闭 前 就 已 经 被 初始 化 了 。 当 

然 ， 我 们 可 以 通过 强行 调用 cat.getSex() 或 者 cat.getKittens().size() 之 
类 的 方法 来 确保 这 一 点 。 但 是 这 样 的 程序 会 造成 读者 的 疑惑 ， 也 不 符合 通常 的 代码 
规范 。 


静态 方法 Hibernate.initialized() 为 你 的 应 用 程序 提供 了 一 个 便捷 的 途径 来 
延迟 加 载 集合 或 代理 。 只 要 它 的 Session 久 于 open 状 

Æ, Hibernate.initialize(cat) 将 会 为 cat 强 制 对 代理 实例 化 。 同 

Æ, Hibernate.initialize( cat.getKittens() ) 对 kittens 的 集合 具有 同 祥 
的 功能 。 


还 有 另外 一 种 选择 ， 就 是 保持 Session 一 直 久 于 open 状 态 ， 直 到 所 有 需要 的 集合 
或 代理 都 被 载 和 人。 在 某 些 应 用 架构 中 ， 特 别 是 对 于 那些 使 用 Hibernate 进 行 数据 访 
问 的 代码 ， 以 及 那些 在 不 同 应 用 屋 和 不 同 物理 进 程 中 使 用 Hibernate 的 代码 。 ER 
合 实例 化 时 ， 如 何 保证 Session 处 于 open 状 态 经 常会 是 一 个 问题 。 有 两 种 方法 可 
以 解决 此 问题 : 


。 在 一 个 基于 Web 的 应 用 中 ， 可 以 利用 servlet 过 滤器 (filter) ， 在 用 户 请 求 
(request) 结束 、 页 面 生 成 结束 时 关闭 Session (这 里 使 用 了 在 展示 层 保 
持 打 开 Session 模 式 (Open Session in View) ) ， 当然 ， 这 将 依赖 于 应 用 框 
架 中 异常 需要 被 正确 的 处 理 。 在 返回 界面 给 用 户 之 前 ， 乃 至 在 生成 界面 过 程 中 
发 生 异 常 的 情况 下 ， 正确 关闭 Session 和 结束 事务 将 是 非常 重要 的 ， 请 参见 
Hibernate wiki 上 的 "Open Session in View" 模 式 ， 你 可 以 找到 示例 。 


。 在 一 个 拥有 单独 业务 层 的 应 用 中 ， 业 务 层 必须 在 返回 之 前 ， 为 web 层 “准备 "好 
其 所 需 的 数据 集合 。 这 就 意味 着 业务 层 应 该 载 人 所 有 表现 层 /web 层 所 需 的 数 
据 ， 并 将 这 些 已 实例 化 完毕 的 数据 返回 。 通 常 ， 应 用 程序 应 该 为 web 层 所 需 的 
每 个 集合 调用 Hibernate.initialize() (这 个 调用 必须 发 生 响 session 关闭 
之 前 ) ; 或 者 使 用 带 有 FETCH 从 句 ， 或 FetchMode. JOIN 的 Hibernate 坦 
询 ， 事先 取得 所 有 的 数据 集合 。 如 果 你 在 应 用 中 使 用 了 Command 模 式 ， 代 蔡 
Session Facade ， 那么 这 项 任务 将 会 变 得 简单 的 多 。 


你 也 可 以 通过 merge() 或 lock() 方法 ， 在 访问 未 实例 化 的 集合 (或 代理 ) 
之 前 ， 为 先前 载 入 的 对 象 绑 定 一 个 新 的 Session. 显然 ，Hibernate 将 不 
会 ， 也 不 应 该 自动 完成 这 些 任务 ， 因 为 这 将 引入 一 个 特殊 的 事务 语义 。 


有 时 候 ， 你 并 不 需要 完全 实例 化 整个 大 的 集合 ， 仅 需要 了 解 它 的 部 分 信息 (例如 其 
大 小 ) 、 或 者 集合 的 部 分 内 容 。 


你 可 以 使 用 集合 过 滤器 得 到 其 集合 的 大 小 ， 而 不 必 实 例 化 整个 集合 : 


"select count(*)" ).list() 


ll 


( (Integer) s.createFilter( collection, 








‘| 

这 里 的 createFilter() 方法 也 可 以 被 用 来 有 效 的 抓 取 集合 的 部 分 内 容 ， 而 无 需 

实例 化 整个 集合 : 

"").setFirstResult(0).setMaxResult: 
= 7 


s.createFilter( lazyCollection, 








d 


19.1.5. 使 用 批量 抓 取 (Using batch fetching) 


Hibernate 可 以 充分 有 效 的 使 用 批量 抓 取 ， 也 就 是 说 ， 如 果 仅 一 个 访问 代理 (RE 
A) ， 那 么 Hibernate 将 不 载 入 其 他 未 实例 化 的 代理 。 批量 抓 取 是 延迟 查询 抓 取 的 
优化 方案 ， 你 可 以 在 两 种 批量 抓 取 方 案 之 间 进 行 选择 : 在 类 级 别 和 集合 级 别 。 


类 /实体 级 别 的 批量 抓 取 很 容易 理解 。 假 设 你 在 运行 时 将 需要 面 对 下 面 的 问题 : 你 在 
一 个 session 中 载 入 了 25 个 cat 实例 ， 每 个 cat 实例 都 拥有 一 个 引用 成 

员 owner , 其 指向 Person ， 而 Person 类 是 代理 ， 同 时 lazy="true" 。 如 
果 你 必须 通 历 整个 cats 集 合 ， 对 每 个 元 素 调 用 getowner() 方法 ，Hibernate 将 会 
默认 的 执行 25 次 SELECT 查询 ， 得 到 其 owner 的 代理 对 象 。 这 时 ， 你 可 以 通过 在 映 
射 文件 的 Person 属性 ， 显 式 声 明 batch-size ， 改 变 其 行为 : 


<class name="Person" batch-size="10">...</class> 


随 之 ，Hibernate 将 只 需要 执行 三 次 查询 ， 分 别 为 10、10、 5 


你 也 可 以 在 集合 级 别 定义 批量 抓 取 。 例 如 ， 如 果 每 个 Person 都 拥有 一 个 延迟 载 入 
的 cats RA, 现在， Sesssion 中 载 人 了 10 个 person 对 象 ， 通 万 person 集 合 将 
会 引起 10 次 SELECT 查询 ， 每 次 查询 都 会 调用 getcats() 方法 。 如 果 你 

在 Person 的 映射 定义 部 分 ， 人 允许 对 cats 批量 抓 取 , 那么 ，Hibernate 将 可 以 预先 
抓 取 整个 集合 。 请 看 例子 : 


<class name="Person"> 
<set name="cats" batch-size="3"> 


</set> 
</class> 


如 果 整 个 的 batch-size 23 (#34?) ， 那 么 Hibernate 将 会 分 四 次 执 
行 SELECT 查询 ， 按照 3、3、3、1 的 大 小 分 别 载 入 数据。 这 里 的 每 次 载 和 的 数据 
量 还 具体 依赖 于 当前 Session 中 未 实例 化 集合 的 个 数 。 


如 果 你 的 模型 中 有 斤 套 的 树 状 结 构 ， 例 如 典型 的 帐 单 一 原料 结构 (bill-of-materials 
pattern) ， 集 合 的 批量 抓 取 是 非常 有 用 的 。 (尽管 在 更 多 情况 下 对 树 进行 读 取 时 ， 
REES (nested set) KEE (materialized path) (xx) 是 更 好 的 解决 方 
法 。) 


19.1.6. 使 用 子 查 询 抓 取 (Using subselect 
fetching) 
假若 一 个 延迟 集合 或 单 值 代 理 需 要 抓 取 ，Hibernate 会 使 用 一 个 subselect 重 新 运行 


原来 的 查询 ， 一 次 性 读 入 所 有 的 实例 。 这 和 批量 抓 取 的 实现 方法 是 一 样 的 ， 不 会 有 
破碎 的 加 载 。 


19.1.7. 使 用 延迟 属性 抓 取 (Using lazy property 
fetching) 


Hibernate3 对 单独 的 属性 支持 延迟 抓 取 ， 这 项 优化 技术 也 被 称 为 组 抓 取 (fetch 
groups) 。 请 注意 ， 该 技术 更 多 的 属于 市 场 特 性 。 在 实际 应 用 中 ， 优 化 行 读 取 比 优 
化 列 读 取 更 重要 。 但 是 ， 信 载 入 类 的 部 分 属性 在 某 些 特定 情况 下 会 有 用 ， 例 如 在 原 
有 表 中 拥有 几 百 列 数据 、 数 据 模型 无 法 改动 的 情况 下 。 


可 以 在 映射 文件 中 对 特定 的 属性 设置 lazy ， 定 义 该 属性 为 延迟 载 人 。 


<class name="Document"> 
<id name="id"> 
<generator class="native"/> 

</id> 

<property name="name" not-null="true" length="50"/> 

<property name="Summary" not-null="true" length="200" lazy="trt 

<property name="text" not-null="true" length="2000" lazy="true' 
</class> 


| TT 


属性 的 延迟 载 人 要 求 在 其 代码 构建 时 加 入 二 进 制 指示 指令 (bytecode 
instrumentation) ， 如 果 你 的 持久 类 代码 中 未 含有 这 些 指令， Hibernate 将 会 忽略 
这 些 属性 的 延迟 设置， (GRR SHER A. 


你 可 以 在 Ant 的 Task 中 ， 进 行 如 下 定义 ， 对 持久 类 代码 加 入 “二 进 制 指令 。” 





<target name="instrument" depends="compile"> 
<taskdef name="instrument" classname="org.hibernate.tool.instrt 
<classpath path="${jar.path}"/> 
<classpath path="${classes.dir}"/> 
<classpath refid="lib.class.path"/> 
</taskdef> 


<instrument verbose="true"> 
<fileset dir="${testclasses.dir}/org/hibernate/auction/mode 
<include name="*.class"/> 
</fileset> 
</instrument> 
</target> 


1 寻 


还 有 一 种 可 以 优化 的 方法 ， 它 使 用 HQL 或 条 件 查询 的 投影 (projection) 特性 ， 可 以 
避免 读 取 非 必要 的 列 ， 这 一 点 至 少 对 只 读 事务 是 非常 有 用 的 。 它 无 需 在 代码 构建 
时 “二 进 制 指 合 ” 处 理 ， 因 此 是 一 个 更 加 值得 选择 的 解决 方法 。 


有 时 你 需要 在 HQL 中 通过 抓 取 所 有 属性 ， 强 行 抓 取 所 有 内 容 。 
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19.2. 二 级 缓存 (The Second Level Cache) 


Hibernate 的 Session 在 事务 级 别 进行 持久 化 数据 的 缓存 操作 。 当然 ， 也 有 可 能 
分 别 为 每 个 类 或 集合 )， 配 置 集 群 、 或 JVM 级 别 ( SessionFactory 级 别 ) 的 缓存 。 
你 甚至 可 以 为 之 插入 一 个 集群 的 缓存 。 注 意 ， 缓 存 永 远 不 知道 其 他 应 用 程序 对 持久 
化 仓库 (数据 库 ) 可 能 进行 的 修改 〈 即 使 可 以 将 缓存 数据 设 定 为 定期 失效 ) 。 


通过 在 hibernate.cache.provider_class 属性 中 指 

定 org.hibernate.cache.CacheProvider 的 某 个 实现 的 类 名 ,你 可 以 选择 让 
Hibernate 使 用 哪个 缓存 实现 。Hibernate 打 包 一 些 开 源 缓存 实现 ， 提 供 对 它们 的 内 
exit 〈 见 下 表 ) 。 除 此 之 外 ， 你 也 可 以 实现 你 自己 的 实现 ， 将 它们 插入 到 系统 
中 。 注 意 ， 在 3.2 版 本 之 前 ， 默 认 使 用 EhCache 作为 缓存 实现 ， 但 从 3.2 起 就 不 再 这 
样 了 。 


表 19.1. 缓存 策略 提供 商 (Cache Providers) 


Cache Provider class Tyr 
Hashtable 
(not intended 
for org. hibernate.cache.HashtableCacheProvider memor 
production 
use) 
EHCache org. hibernate.cache.EhCacheProvider cen 
| 
OSCache org. hibernate.cache.OSCacheProvider oe 
| 
SwarmCache org. hibernate.cache.SwarmCacheProvider cluster¢ 
multica 
JBoss clusters 
ofg.hibernate.cache:. InreeCacherrovider j 
TreeCache g multica 


transac 


19.2.1. 缓存 映射 (Cache mappings) 
类 或 者 集合 映射 的 * &lt;cache&gt; 元 素 " 可 以 有 下 列 形式 : 


<Cache 
usage="transactional|read-write|nonstrict-read-write|read-only' 
region="RegionName" 
include="all|non-lazy" 

/> 


| 


usage (必须 ) 说 明了 缓存 的 策略 : transactional, read-write 、 
nonstrict-read-write 或 read-only 。 
region (可 选 , 默认 为 类 或 者 集合 的 名 字 (class or collection role name)) 指 


o t — 


定 第 二 级 缓存 的 区 域名 (name of the second level cache region) 


include (可 选 ,默认 为 all ) non-lazy 当 属 性 级 延迟 抓 取 打开 时 , 标 


© jz lazy="true" 的 实体 的 属性 可 能 无 法 被 缓存 


另外 (首选 ?), 你 可 以 在 hibernate.cfg.xml 中 指定 &lt;class-cache&gt; 和 
&lt;collection-cache&gt; 元 素 。 


这 里 的 usage 属性 指明 了 缓存 并 发 策略 (cache concurrency strategy) 。 


19.2.2. 策略 : 只 读 缓存 (Strategy: read only) 


如 果 你 的 应 用 程序 只 需 读 取 一 个 持久 化 类 的 实例 ， 而 无 需 对 其 修改 ， 那么 就 可 以 对 
其 进行 Rit 缓存 。 这 是 最 简单 ， 也 是 实用 性 最 好 的 方法 。 甚 至 在 集群 中 ， 它 也 能 
完美 地 运作 。 


<class name="eg.Immutable" mutable="false"> 
<cache usage="read-only"/> 


</class> 


19.2.3. 策略 : 读 / 写 缓存 (Strategy: read/write) 


如 果 应 用 程序 需要 更 新 数据 ， 那 么 使 用 读 / 宇 缓存 比较 合适 。 如 果 应 用 程序 要 
求 “ 序 列 化 事务 "的 隔离 级 别 (serializable transaction isolation level) ， 那 么 就 决 不 
能 使 用 这 种 缓存 策略 。 如 果 在 JTA 环 境 中 使 用 缓存 ， 你 必须 指 

定 hibernate.transaction.manager_lookup_class 属性 的 值 ， 通 过 它 ， 
Hibernate 才 能 知道 该 应 用 程序 中 JTA 的 TransactionManager 的 具体 策略 。 在 其 
它 环 境 中 ， 你 必须 保证 在 Session.close() 、 或 Session.disconnect() 调用 
前 ， 整个 事务 已 经 结束 。 如 果 你 想 在 集群 环境 中 使 用 此 策略 ， 你 必须 保证 底层 的 
缓存 实现 支持 锁定 (locking)。Hibernate 内 和 置 的 缓存 策略 并 不 支持 锁定 功能 。 


<class name="eg.Cat" .... > 
<cache usage="read-write"/> 


<set name="kittens" ... > 
<cache usage="read-write"/> 


</set> 
</class> 


19.2.4. 策略 : 非 严格 读 / 瑟 缓存 (Strategy: 
nonstrict read/write) 


如 果 应 用 程序 只 偶尔 需要 更 新 数据 (也 就 是 说 ， 两 个 事务 同时 更 新 同一 记录 的 情况 
很 不 常见 ) ， 也 不 需要 十 分 严格 的 事务 隔离 ， 那么 比较 适合 使 

用 非 严 格 读 / 写 缓存 策略 。 如 果 在 JTA 环 境 中 使 用 该 策略 ， 你 必须 为 其 指 

定 hibernate.transaction.manager_lookup_class 属性 的 值 ， 在 其 它 环境 
中 ， 你 必须 保证 在 Session.close() 、 或 Session.disconnect() 调用 前 ， 整 


个 事务 已 经 结束 。 


19.2.5. REG: +4244 (transactional) 


Hibernate 的 事务 缓存 策略 提供 了 全 事务 的 缓存 支持 ， 例如 对 JBoss TreeCache 的 
支持 。 这 样 的 缓存 只 能 用 于 JTA 环 境 中 ， 你 必须 指定 为 

其 hibernate.transaction.manager_lookup_class 属性 。 

没有 一 种 缓存 提供 商 能 够 支持 上 列 的 所 有 缓存 并 发 策略 。 下 表 中 列 出 了 各 种 提供 
器 、 及 其 各 自 适 用 的 并 发 策略 。 

K 19.2. 各 种 缓存 提供 商 对 缓存 并 发 策略 的 支持 情况 (Cache Concurrency 
Strategy Support) 


Cache hss ; anata oe transactional 
for production use) | Ye ‘| YS yes 
EHCache yes yes yes 
OSCache yes yes yes 
SwarmCache yes yes 


JBoss TreeCache yes yes 


19.3. 管理 缓存 (Managing the caches) 


无 论 何 时 ， 当 你 给 save() 、 update() 或 saveOrUpdate() 方法 传递 一 个 对 
象 时 ， 或 使 用 load() 、 get() 、 list() 、 iterate() 或 scroll() 方法 
获得 一 个 对 象 时 , 该 对 象 都 将 被 加 入 到 Session 的 内 部 缓存 中 。 


当 随 后 flush() 方 法 被 调用 时 ， 对 象 的 状态 会 和 数据 库 取得 同步 。 如 果 你 不 希望 此 同 
步 操作 发 生 ， 或 者 你 正 处 理 大 量 对 象 、 需 要 对 有 效 管理 内 存 时 ， 你 可 以 调 
用 evict() 方法 ， 从 一 级 缓存 中 去 掉 这 些 对 象 及 其 集合 。 


ScrollableResult cats = sess.createQuery("from Cat as cat").scrolli 
while ( cats.next() ) { 

Cat cat = (Cat) cats.get(0); 

doSomethingwWithACat(cat); 

sess.evict(cat); 


e 放 
Session 还 提供 了 一 个 contains() 方法 ， 用 来 判断 某 个 实例 是 否 处 于 当前 session 
的 缓存 中 。 

如 若 要 把 所 有 的 对 象 从 session 缓 存 中 彻底 清除 ， 则 需要 调 


用 Session.clear() 。 


对 于 二 级 缓存 来 说 ， 在 SessionFactory 中 定义 了 许多 方法 ， 清除 缓存 中 实例 、 
整个 类 、 集 合 实例 或 者 整个 集合 。 





sessionFactory.evict(Cat.class, catId); //evict a particular Cat 
sessionFactory.evict(Cat.class); //evict all Cats 
sessionFactory.evictCollection("Cat.kittens", catId); //evict a pat 
sessionFactory.evictCollection("Cat.kittens"); //evict all kitten ( 


BEE | 





CacheMode 参数 用 于 控制 具体 的 Session 如 何 与 二 级 缓存 进行 交互 。 
e CacheMode.NORMAL - 从 二 级 缓存 中 读 、 写 数据 。 


e CacheMode.GET - 从 二 级 缓存 中 读 取 数据 ， 仅 在 数据 更 新 时 对 二 级 缓存 写 数 
据 。 


e CacheMode.PUT - 仅 向 二 级 缓存 写 数 据 ， 但 不 从 二 级 缓存 中 读数 据 。 


e CacheMode.REFRESH - 仅 向 二 级 缓存 写 数 据 ， 但 不 从 二 级 缓存 中 读数 据 。 通 
过 hibernate.cache.use_minimal_puts 的 设置 ， 强 制 二 级 缓存 从 数据 库 中 
读 取 数 据 ， 刷 新 缓存 内 容 。 


如 若 需 要 查看 二 级 缓存 或 查询 缓存 区 域 的 内 容 ， 你 可 以 使 用 统计 (Statistics) 
API. 


Map cacheEntries = sessionFactory.getStatistics() 
.getSecondLevelCacheStatistics(regionName ) 
.getEntries(); 


此 时 ， 你 必须 手工 打开 统计 选项 。 可 选 的 ， 你 可 以 让 Hibernate 更 人 工 可 读 的 方式 维 
扩 缓 存 内 容 。 


hibernate.generate_statistics true 
hibernate.cache.use_structured_entries true 


19.4. 查询 缓存 (The Query Cache) 


查询 的 结果 集 也 可 以 被 缓存 。 只 有 当 经 常 使 用 同样 的 参数 进行 查询 时 ， 这 才 会 有 些 
用 处 。 要 使 用 查询 缓存 ， 首 先 你 必须 打开 它 : 


hibernate.cache.use_query_cache true 


该 设置 将 会 创建 两 个 缓存 区 域 - 一 个 用 于 保存 查询 结果 集 

( org.hibernate.cache.StandardQueryCache ) ; 另 一 个 则 用 于 保存 最 近 查 询 的 
一 系列 表 的 时 间 惟 ( org.hibernate.cache.UpdateTimestampsCache )。 请 注 
意 : 在 查询 缓存 中 ， 它 并 不 缓存 结果 集中 所 包含 的 实体 的 确切 状态 ; 它 只 缓存 这 些 
wise ee 
使 用 。 


绝 大 多 数 的 查询 并 不 能 从 查询 缓存 中 受益 ， 所 以 Hibernate 默 认 是 不 进行 查询 缓存 
的 。 如 若 需 要 进行 缓存 ， 请 调用 Query.setCacheable(true) 方法 。 这 个 调用 会 
让 查询 在 执行 过 程 中 时 先 从 缓存 中 查找 结果 ， 并 将 自己 的 结果 集 放 到 缓存 中 去 。 


如 果 你 要 对 查询 缓存 的 失效 政策 进行 精确 的 控制 ， 你 必须 调 
用 Query.setCacheRegion() 方法 ， 为 每 个 查询 指定 其 命名 的 缓存 区 域 。 


List blogs = sess.createQuery("from Blog blog where blog.blogger = 
.setEntity("blogger", blogger) 
.setMaxResults(15) 
.setCacheable( true) 
.setCacheRegion("frontpages" ) 
.list(); 


SS eS 


如 果 查 询 需 要 强行 刷新 其 查询 缓存 区 域 ， 那 么 你 应 该 调 

用 query.setCacheMode(CacheMode.REFRESH) 方法 。 这 对 在 其 他 进程 中 修改 底 
层 数据 (例如 ， 不 通过 Hibernate 修 改 数据 ) ， 或 对 那些 需要 选择 性 更 新 特定 查询 结 
果 集 的 情况 特别 有 用 。 这 是 对 SessionFactory.evictQueries() 的 更 为 有 效 的 
替代 方案 ， 同 样 可 以 清除 查询 缓存 区 域 。 





19.5. 理解 集合 性 能 (Understanding Collection 
performance) 


前 面 我 们 已 经 对 集合 进行 了 足够 的 讨论 。 本 段 中 ， 我 们 将 着 重 讲述 集合 在 运行 时 的 
事宜 。 


19.5.1. 分 类 (Taxonomy) 


Hibernate 定 义 了 三 种 基本 类 型 的 集合 : 
。 值 数据 集合 
© 一 对 多 关联 
© 多 对 多 关联 


这 个 分 类 是 区 分 了 不 同 的 表 和 外 键 关 系 类 型 ， 但 是 它 没 有 告诉 我 们 关系 模型 的 所 有 
内 容 。 要 完全 理解 他 们 的 关系 结构 和 性 能 特点 ， 我 们 必须 同时 考虑 “用 于 Hibernate 
更 新 或 删除 集合 行 数据 的 主键 的 结构 ”"”。 因此 得 到 了 如 下 的 分 类 : 


。 有 序 集合 类 
。 集合 (sets) 
e © (bags) 


所 有 的 有 序 集 合 类 (maps, lists, arrays) 都 拥有 一 个 由 &lt;key&gt; 和 
&lt;indexagt; 组 成 的 主键 。 这 种 情况 下 集合 类 的 更 新 是 非常 高 效 的 一 一 主键 已 
经 被 有 效 的 索引 ， 因 此 当 Hibernate 试 图 更 新 或 删除 一 行 时 ， 可 以 迅速 找到 该 行 数 
据 。 


集合 (sets) 的 主键 由 &1t ;key&gt; 和 其 他 元 素 字 段 构成 。 对 于 有 些 元 素 类 型 来 
说 ， 这 很 低 效 ， 特 别 是 组 合 元 素 或 者 大 文本 、 大 二 进 制 字段 ; 数据 库 可 能 无 法 有 效 
的 对 复杂 的 主键 进行 索引 。 另 一 方面 ， 对 于 一 对 多 、 多 对 多 关联 ， 特 别 是 合成 的 标 
识 符 来 说 ， 集 合 也 可 以 达到 同样 的 高 效 性 能 。 ( 附注 : 如 果 你 希 

望 SchemaExport 为 你 的 &lt;setagt; 创建 主键 ， 你 必须 把 所 有 的 字段 都 声明 
为 not-null="true" 。) 


&lt;idbag&gt; 了 映射 定义 了 代理 键 ， 因 此 它 总 是 可 以 很 高 效 的 被 更 新 。 事 实 上 ， 
&lt;idbag&gt; 拥有 着 最 好 的 性 能 表现 。 


Bag 是 最 差 的 。 因 为 bag 人 允许 重复 的 元 素 值 ， 也 没有 索引 字段 ， 因 此 不 可 能 定义 主 
键 。 Hibernate 无 法 判断 出 重复 的 行 。 当 这 种 集合 被 更 改 时 ，Hibernate 将 会 先 完整 
地 移 除 (通过 一 个 (in a single DELETE )) 整个 集合 ， 然 后 再 重新 创建 整个 集合 。 
因此 Bag 是 非常 低 效 的 。 


请 注意 : 对 于 一 对 多 关联 来 说 , “主键 "很 可 能 并 不 是 数据 库 表 的 物理 主键 。 但 就 算 
在 此 情况 下 ， 上 面 的 分 类 仍然 是 有 用 的 。 ( 它 仍 然 反 映 了 Hibernate 在 集合 的 各 数据 
行 中 是 如 何 进行 “定位 ”的 。) 


19.5.2. Lists, maps 和 sets 用 于 更 新 效率 最 高 


根据 我 们 上 面 的 讨论 ， 显 然 有 序 集合 类 型 和 大 多 数 set 都 可 以 在 增加 、 删 除 、 修 改元 
素 中 拥有 最 好 的 性 能 。 


可 论证 的 是 对 于 多 对 多 关联 、 值 数据 集合 而 言 ， 有 序 集合 类 比 集 合 (set) 有 一 个 好 
处 。 因 为 Set 的 内 在 结构 ， 如果“ 改变" 了 一 个 元 素 ，Hibernate 并 不 

会 更 新 (UPDATE) 这 一 行 。 对 于 Set Kit, RA 

在 插入 (INSERT) 和 删除 (DELETE) ”操作 时 “改变 ” 才 有 效 。 再 次 强调 : 这 段 讨 
论 对 “一 对 多 关联 ”并 不 适用 。 


注意 到 数组 无 法 延迟 载 入 ， 我 们 可 以 得 出 结论 ，list, map 和 idbags 是 最 高 效 的 ( 非 
RA) 集合 类 型 ，set 则 紧 随 其 后 。 在 Hibernate 中 ，set 应 该 时 最 通用 的 集合 类 型 ， 
这 时 因为 “set” 的 语义 在 关系 模型 中 是 最 自然 的 。 


但 是 ， 在 设计 良好 的 Hibernate 领 域 模 型 中 ， 我 们 通常 可 以 看 到 更 多 的 集合 事实 上 是 
带 有 inverse="true" 的 一 对 多 的 关联 。 对 于 这 些 关 联 ， 更 新 操作 将 会 在 多 对 一 
的 这 一 端 进行 多 理 。 因 此 对 于 此 类 情况 ， 无 需 考 虑 其 集合 的 更 新 性 能 。 


19.5.3. Bag 和 list 是 反 向 集合 类 中 效率 最 高 的 


在 把 bag 扔 进 水 沟 之 前 ， 你 必须 了 解 ， 在 一 种 情况 下 ，bag 的 性 能 (包括 list) 要 比 set 
高 得 多 : 对 于 指明 了 inverse="true" 的 集合 类 (比如 说 ， 标 准 的 双向 的 一 对 多 
关联 ) ， 我 们 可 以 在 未 初始 化 (fetch) 包 元 素 的 情况 下 直接 向 bag 或 list 添 加 新 元 素 ! 
这 是 因为 Collection.add() ) 或 者 Collection.addAll() 方法 对 bag 或 者 List 


总 是 返回 true (这 点 与 与 Set 不 同 ) 。 因 此 对 于 下 面 的 相同 代码 来 说 ， 速 度 会 快 得 
多 


o 


Parent p = (Parent) sess.load(Parent.class, id); 
Child c = new Child(); 
c.setParent(p); 
p.getChildren().add(c); //no need to fetch the collection! 
sess.flush(); 


19.5.4. 一 次 性 删除 (One shot delete) 


偶尔 的 ， 逐 个 删除 集合 类 中 的 元 素 是 相当 低 效 的 。Hibernate 并 没 那么 笨 ， 如 果 你 
想 要 把 整个 集合 都 删除 (比如 说 调用 list.clear()) ，Hibernate 只 需要 一 个 DELETE 
就 搞定 了 。 


假设 我 们 在 一 个 长 度 为 20 的 集合 类 中 新 增加 了 一 个 元 素 ， 然 后 再 删除 两 个 。 
Hibernate 会 安排 一 条 INSERT 语句 和 两 条 DELETE 语句 (除非 集合 类 是 一 个 
bag)。 这 当然 是 显而易见 的 。 


但 是 ， 假 设 我 们 删除 了 18 个 数据 ， 只 剩 下 2 个 ， 然 后 新 增 3 个 。 则 有 两 种 义理 方式 : 
e 逐一 的 删除 这 18 个 数据 ， 再 新 增 三 个 ; 
e 删除 整个 集合 类 (只 用 一 句 DELETE 语句 ) ， 然 后 增加 5 个 数据 。 


Hibernate 还 没 那么 聪明 ， 知 道 第 二 种 选择 可 能 会 比较 快 。 (也 许 让 Hibernate 不 这 
么 联 明 也 是 好 事 ， 否 则 可 能 会 引发 意外 的 "数据库 触 发 器 "之 类 的 问题 。) 


幸运 的 是 ， 你 可 以 强制 使 用 第 二 种 策略 。 你 需要 取消 原来 的 整个 集合 类 (解除 其 引 
然后 再 返回 一 个 新 的 实例 化 的 集合 类 ， 只 包含 需要 的 元 素 。 有 些 时 候 这 是 非 
常 用 的 。 


显然 ， 一 次 性 删除 并 不 适用 于 被 映射 为 inverse="true" 的 集合 。 





19.6. 监测 ' 


没有 监测 和 性 能 参数 而 进行 优化 是 宫 无 意义 的 。Hibernate 为 其 内 部 操作 提供 了 一 系 
列 的 示意 图 ， 因 此 可 以 从 每 个 SessionFactory 抓 取 其 统计 数据 。 


生 能 (Monitoring performance) 


19.6.1. 监测 SessionFactory 


你 可 以 有 两 种 方式 访问 SessionFactory 的 数据 记录 ， 第 一 种 就 是 自己 直接 调用 
sessionFactory.getStatistics() 方法 读 取 、 显 示 统计 数据 。 


此 外 ， 如 果 你 打开 StatisticsService MBean 选 项 ， 那 么 Hibernate 则 可 以 使 用 
JMX 技 术 发 布 其 数据 记录 。 你 可 以 让 应 用 中 所 有 的 SessionFactory 同时 共享 一 
个 MBean， 也 可 以 每 个 SessionFactory 分 配 一 个 MBean。 下 面 的 代码 即 是 其 演示 
代码 : 


// MBean service registration for a specific SessionFactory 
Hashtable tb = new Hashtable(); 

tb.put("type", "statistics"); 

tb.put("sessionFactory", "myFinancialApp"); 

ObjectName on = new ObjectName("hibernate", tb); // MBean object ni 


StatisticsService stats = new StatisticsService(); // MBean impleme 
stats.setSessionFactory(sessionFactory); // Bind the stats to a Se: 
server.registerMBean(stats, on); // Register the Mbean on the serve 


ee 





// MBean service registration for all SessionFactory's 

Hashtable tb = new Hashtable(); 

tb.put("type", "statistics"); 

tb.put("sessionFactory", "all"); 

ObjectName on = new ObjectName("hibernate", tb); // MBean object ni 


StatisticsService stats = new StatisticsService(); // MBean impleme 
server.registerMBean(stats, on); // Register the MBean on the serve 


VETE = 


TODO : 仍 需 要 说 明 的 是 : 在 第 一 个 例子 中 ， 我 们 直接 得 到 和 使 用 MBean ; 而 在 第 
二 个 例子 中 ， 在 使 用 MBean 之 前 我 们 则 需要 给 出 SessionFactory 的 JNDI 名 ， 使 

用 hibernateStatsBean.setSessionFactoryJNDIName("my/JNDI/Name") 得 到 
SessionFactory， 然 后 将 MBean 保 存 于 其 中 。 


你 可 以 通过 以 下 方法 打开 或 关闭 SessionFactory 的 监测 功能 : 


e 在 配置 期 间 ， 将 hibernate.generate_statistics 设置 
为 true 或 false ; 


e 在 运行 期 间 ， 则 可 以 可 以 通 
过 sf.getStatistics().setStatisticsEnabled(true) 
或 hibernateStatsBean.setStatisticsEnabled(true) 





你 也 可 以 在 程序 中 调用 clear() 方法 重 置 统计 数据 ， 调 用 logSummary() 在 日 
志 中 记录 (info 级别 ) 其 总 结 。 


19.6.2. 数据 记录 (Metrics) 


Hibernate 提 供 了 一 系列 数据 记录 ， 其 记录 的 内 容 包 括 从 最 基本 的 信息 到 与 具体 场景 
的 特殊 信息 。 所 有 的 测量 值 都 可 以 由 statistics 接口 进行 访问 ， 主 要 分 为 三 


类 . 


e 使 用 Session 的 普通 数据 记录 ， 例 如 打开 的 Session 的 个 数 、 取 得 的 JDBC 的 
连接 数 等 ; 


e 实体、 集合、 查询 、 缓 存 等 内 容 的 统一 数据 记录 
e 和 具体 实体 、 人 集合、 查询 、 缓 存 相 关 的 详细 数据 记录 


例如 : 你 可 以 检查 缓存 的 命中 成 功 次 数 ， 缓 存 的 命中 失败 次 数 ， 实 体 、 集 合 和 查询 
的 使 用 概率 ， 查 询 的 平均 时 间 等 。 请 注意 Java 中 时 间 的 近似 精度 是 毫秒 。 
Hibernate 的 数据 精度 和 具体 的 JVM 有 关 ， 在 有 些 平 台 上 其 精度 甚至 只 能 精确 到 10 
秒 。 


人 (例如 ， 和 具体 的 实体 、 集 合 、 缓 存 
区 无 关 的 数据 ) ， 你 也 可 以 在 具体 查询 中 通过 标记 实体 名 、 RHAL, SQL 语句 得 到 
某 实 体 的 数据 记录 。 请 参考 Statistics 、 EntityStatistics 、 
CollectionStatistics 、 SecondLevelCacheStatistics 、 

和 QueryStatistics 的 API 文 档 以 抓 取 更 多 信息 。 下 面 的 代码 则 是 个 简单 的 例 
Ff: 


Statistics stats = HibernateUtil.sessionFactory.getStatistics(); 


double queryCacheHitCount 

double queryCacheMissCount 

double queryCacheHitRatio = 
queryCacheHitCount / (queryCacheHitCount + queryCacheMissCount ); 


stats.getQueryCacheHitCount(); 
stats.getQueryCacheMissCount(); 


log.info("Query Hit ratio:" + queryCacheHitRatio); 


EntityStatistics entityStats = 
stats.getEntityStatistics( Cat.class.getName() ); 
long changes = 
entityStats.getInsertCount() 
+ entityStats.getUpdateCount( ) 
+ entityStats.getDeleteCount(); 
log.info(Cat.class.getName() + " changed " + changes + "times" ); 


i 了 议 "| 


如 果 你 想得到 所 有 实体 、 集 合 、 查 询 和 缓存 区 的 数据 ， 你 可 以 通过 以 下 方法 获得 实 
体 、 和 集合、 查询 和 缓存 区 列表 : getQueries() 、 getEntityNames() 、 
getCollectionRoleNames() 和 getSecondLevelCacheRegionNames() o 
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e 20.1. Schema 自动 生成 (Automatic schema generation) 
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20.1.5. 对 schema 的 增 量 更 新 (Incremental schema updates) 
20.1.6. 用 Ant 来 增 量 更 新 schema(Using Ant for incremental schema 
updates) 

o 20.1.7. Schema 校 验 

o 20.1.8. 使 用 Ant 进 行 schema 校 验 


可 以 通过 一 系列 Eclipse 插件 、 命 令 行 工 具 和 Ant 任 务 来 进行 与 Hibernate 关 联 的 转 
换 。 


除了 Ant 任 务 外 ， 当 前 的 Hibernate 7Tools 也 包含 了 Eclipse IDE 的 插件 ， 用 于 与 现存 
数据 库 的 逆向 工程 。 


e Mapping Editor: Hibernate XML 映射 文件 的 编辑 器 ， 支 持 自 动 完 成 和 语法 高 
亮 。 它 也 支持 对 类 名 和 属性 /字段 名 的 语义 自动 完成 ， 比 通常 的 XML 编辑 器 方便 
得 多 。 

e Console: Console 是 Eclipse 的 一 个 新 视图 。 除 了 对 你 的 console 配 置 的 树 状 概 


览 ， 你 还 可 以 获得 对 你 持久 化 类 及 其 关联 的 交互 式 视图 。Console 人 允许 你 对 数 
据 库 执行 HQL 坦 询 ， 并 直接 在 Eclipse 中 浏览 结果 。 


e Development Wizards: 在 Hibernate Eclipse tools 中 还 提供 了 几 个 向 导 ; 你 可 
以 用 向 导 快 速生 成 Hibernate 配置 文件 (cfg.xml) ， 你 甚至 还 可 以 同 现存 的 数 
据 库 schema 中 反 向 工程 出 POJO 源 代码 与 Hibernate 映射 文件 。 反 向 工程 支持 
可 定制 的 模版 。 


e Ant Tasks: 
要 得 到 更 多 信息 ， 请 查阅 Hibernate Tools 包 及 其 文档 。 


同时 ，Hibernate 主 发 行 包 还 附带 了 一 个 集成 的 工具 〈 它 甚至 可 以 在 Hibernate“ 内 
部 ”快速 运行 ) SchemaExport ， 也 就 是 hbm2ddl 。 


O O O O 0 0 


20.1. Schema 目 动 生成 (Automatic schema 
generation ) 
可 以 从 你 的 映射 文件 使 用 一 个 Hibernate 工 具 生 成 DDL。 生成 的 schema 包 含有 对 实 


体 和 集合 类 表 的 完整 性 引用 约束 〈 主 键 和 外 键 ) 。 涉 及 到 的 标示 符 生 成 器 所 需 的 表 
和 sequence 也 会 同时 生成 。 


在 使 用 这 个 工具 的 时 候 ， 你 必须 通过 hibernate.dialet 属性 指定 一 个 
SQL 方言 (Dialet) ， 因 为 DDL 是 与 供应 商 高 度 相 关 的 。 


首先 ， 要 定制 你 的 映射 文件 ， 来 改善 生成 的 schema。 


20.1.1. xtschemaz fill {E(Customizing the 
schema) 


很 多 Hibernate 映 射 元 素 定 义 了 可 选 的 length, precision 或 者 scale B 
性 。 你 可 以 通过 这 个 属性 设置 字段 的 长 度 、 精 度 、 小 数 点 位 数 。 


<property name="zip" length="5"/> 


<property name="balance" precision="12" scale="2"/> 


有 些 tag 还 接受 not-null 属性 〈 用 来 在 表 字 段 上 生成 NOT NULL 约束 ) 
和 unique 属性 〈 用 来 在 表 字 段 上 生成 UNIQUE 约束 ) 。 


<many-to-one name="bar" column="barId" not-null="true"/> 


<element column="SerialNumber" type="Long" not-null="true" unique=' 
AA O :: =: | 


unique-key 属性 可 以 对 成 组 的 字段 指定 一 个 唯一 键 约束 (unique key 
constraint)。 目 前 ， unique-key 属性 指定 的 值 在 生成 DDL 时 并 不 会 被 当 作 这 个 约 
束 的 名 字 ， 它 们 只 是 在 用 来 在 映射 文件 内 部 用 作 区 分 的 。 





<many-to-one name="org" column="orgId" unique-key="OrgEmployeeId"/: 
<property name="employeeId" unique-key="OrgEmployee"/> 


二 "| 


index 属性 会 用 对 应 的 字段 (一 个 或 多 个 ) 生成 一 个 index, 它 指出 了 这 个 index 的 
名 字 。 如 果 多 个 字段 对 应 的 index 名 字 相 同 ， 就 会 生成 包含 这 些 字段 的 index。 


<property name="lastName" index="CustName"/> 
<property name="firstName" index="CustName"/> 


foreign-key 属性 可 以 用 来 覆盖 任何 生成 的 外 键 约 束 的 名 字 。 


<many-to-one name="bar" column="barId" foreign-key="FKFooBar"/> 


很 多 映射 元 素 还 接受 &1t;column&gt; 子 元 素 。 这 在 定义 跨越 多 字段 的 类 型 时 特 
别 有 用 。 


<property name="name" type="my.customtypes.Name"/> 
<column name="last" not-null="true" index="bar_idx" length="30' 
<column name="first" not-null="true" index="bar_idx" length="2( 
<column name="initial"/> 

</property> 


«| = 








default 属性 为 字段 指定 一 个 默认 值 (在 保存 被 映射 的 类 的 新 实例 之 前 ， 你 应 该 
将 同样 的 值 赋 于 对 应 的 属性 )。 


<property name="credits" type="integer" insert="false"> 
<column name="credits" default="10"/> 
</property> 


<version name="version" type="integer" insert="false"> 
<column name="version" default="0"/> 
</property> 


sql-type 属性 允许 用 户 覆 盖 默 认 的 Hibernate 类 型 到 SQL 数据 类 型 的 映射 。 


<property name="balance" type="float"> 
<column name="balance" sql-type="decimal(13,3)"/> 
</property> 


check 属性 允许 用 户 指定 一 个 约束 检查 。 


<property name="foo" type="integer"> 
<column name="foo" check="foo > 10"/> 
</property> 


<class name="Foo" table="foos" check="bar < 100.0"> 


<property name="bar" type="float"/> 
</class> 


K 20.1. Summary 


属性 (Attribute) 值 (Values) 解释 (Interpretatior 


length 数字 FRKE 

precision 数字 精度 (decimal precision) 

scale 数字 小 数 点 位 数 (decimal scale) 
not-null true&#124;false 指明 字段 是 否 应 该 是 非 空 的 

unique true&#124; false 虽 明 是 否 该 字段 具有 惟一 约束 
index index_name 指明 一 个 (多 字段 ) 的 素 引 (index) 的 
unique-key unique_key_name 指明 多 字段 惟一 约束 的 名 字 (参见 上 


specifies the name of the foreign key 
generated for an association, for a 
&lt;one-to-one&gt; , &lt;many 
&lt;key&gt; ,or &lt;many-to-m 
mapping element. Note that invers 
foreign-key foreign_key_name will not be considered by SchemaEx 
外 键 的 名 字 ， 它 是 为 关联 生成 的 ， 或 
者 &lt;one-to-one&gt; , &lt;me 
&lt;key&gt; ,或 者 &lt;many-to- 
Juss. 注意 inverse="true" 在 Sc 


被 忽略 。 
SEE SQL 字段 类 型 fe enn RE 
default SQL 表达 式 为 字段 指定 默认 值 
check SQL 表达 式 对 字段 或 表 加 入 SQL 约束 检查 


&lt;commentagt; 元 素 可 以 让 你 在 生成 的 schema 中 加 入 注释 。 


<class name="Customer" table="CurCust"> 
<comment>Current customers only</comment> 


</class> 


<property name="balance"> 
<column name="bal"> 
<comment>Balance in USD</comment> 
</column> 
</property> 


结果 是 在 生成 的 DDL 中 包含 comment on table 或 者 comment on column 语句 
(假若 支持 的 话 )。 


20.1.2. 运行 该 工具 


SchemaExport 工具 把 DDL 脚 本 写 到 标准 输出 ， 同 时 /或 者 执行 DDL 语 句 。 


java -cp hibernate_classpaths 


org.hibernate.tool.hbm2dd1.SchemaExport options mapping_files 


K 20.2. SchemaExport MPTA M 


选项 
--quiet 
--drop 
--create 
--text 


--output=my_schema.ddl 
- -naming=eg.MyNamingStrategy 


--config=hibernate.cfg.xml 
--properties=hibernate.properties 
--format 


--delimiter=; 


说 明 
不 要 把 脚本 输出 到 stdout 
只 进行 drop tables 的 步 又 
只 创建 表 
不 执行 在 数据 库 中 运行 的 步 又 
把 输出 的 ddl 脚 本 输出 到 一 个 文件 
选择 一 个 命名 策略 


( NamingStrategy ) 

从 XML 文件 读 和 Hibernate 配置 
从 文件 读 人 数据库 属性 

把 脚本 中 的 SQL 语句 对 齐 和 美化 
为 脚本 设置 行 结束 符 


UR Be BY LATE REY AER BRA SchemaExport LB: 


Configuration cfg =... 


new SchemaExport(cfg). create(false, 


true); 


20.1.3. 属性 (Properties) 


可 以 通过 如 下 方式 指定 数据 库 属 性 : 
e 通过 -D <property> 系 统 参 数 


e JE hibernate.properties 文件 中 


e 位 于 一 个 其 它 名 字 的 properties 文 件 中 ,然后 用 


所 需 的 参数 包括 : 
表 20.3. SchemaExport 连接 属性 


hibernate. 


hibernate. 


hibernate 


hibernate. 


hibernate. 


属 


connection 


connection. 


.connection 


connection 


dialect 


性 名 
.driver_class 
url 

. username 


. password 


--properties 参数 指定 


说 明 
jdbc driver class 
jdbc url 
database user 
user password 


FAB (dialect) 


20.1.4. 使 用 Ant(Using Ant) 
你 可 以 在 你 的 Ant build 脚 本 中 调用 SchemaExport : 


<target name="Schemaexport"> 
<taskdef name="schemaexport" 
classname="org.hibernate.tool.hbm2dd1.SchemaExportTask" 
classpathref="class.path"/> 


<schemaexport 
properties="hibernate.properties" 
quiet="no" 
text="no" 
drop="no" 
delimiter=";" 
output="schema-export.sql"> 
<fileset dir="src"> 

<include name="**/*.hom.xm1l"/> 

</fileset> 

</schemaexport> 

</target> 


20.1.5. 对 schema 的 增 量 更 新 (Incremental 
schema updates) 
SchemaUpdate 工具 对 已 存在 的 Schema 采 用 " 增 量 "方式 进行 更 新 。 注 


意 SchemaUpdate 严重 依赖 于 JDBC metadata APIl, 所 以 它 并 非 对 所 有 JDBC 驱 动 都 
有 效 。 


java -cp hibernate_classpaths 
org.hibernate.tool.hbm2dd1.SchemaUpdate options mapping_files 


表 20.4. SchemaUpdate 命令 行 选项 


选项 说 明 
--quiet 不 要 把 脚本 输出 到 stdout 
ER 不 把 脚本 输出 到 数据 库 
一 个 命名 策略 


--naming=eg.MyNamingStrategy (Wa 


--properties=hibernate.properties 从 指定 文件 读 和 数据库 属性 
--config=hibernate.cfg.xml 指定 一 个 .cfg.xml 文件 


你 可 以 在 你 的 应 用 程序 中 嵌入 SchemaUpdate 工具 


Configuration cfg = .. 
new SchemaUpdate(cfg). ee TT 


20.1.6. 用 Ant 来 增 量 更 新 schema(Using Ant for 
incremental schema updates) 


你 可 以 在 Ant 脚 本 中 调用 SchemaUpdate 


<target name="Schemaupdate"> 
<taskdef name="schemaupdate" 
classname="org.hibernate.tool.hbm2dd1.SchemaUpdateTask" 
classpathref="class.path"/> 


<schemaupdate 
properties="hibernate.properties" 
quiet="no"> 
<fileset dir="src"> 

<include name="**/*.hbom.xm1l"/> 

</fileset> 

</schemaupdate> 

</target> 


20.1.7. Schema 校 验 


SchemaValidator 工具 会 比较 数据 库 现 状 是 否 与 映射 文档 匹配”。 注 
意 ， Schemavalidator 严重 依赖 于 JDBC 的 metadata API， 因 此 不 是 对 所 有 的 
JDBC 驱 动 都 适用 。 这 一 工具 在 测试 的 时 候 特 别 有 用 。 


java -cp hibernate_classpaths 
org.hibernate.tool.hbm2dd1.SchemaValidator options mapping_files 


表 20.5. SchemaValidator 命令 行 参 数 


选项 描述 
一 个 命名 策略 


( NamingStrategy ) 


--properties=hibernate.properties 从 文件 中 读 取 数据 库 属 性 
--config=hibernate.cfg.xml 指定 一 个 .cfg.xml 文件 


- -naming=eg.MyNamingStrategy 


你 可 以 在 你 的 应 用 程序 中 人 散人 SchemaValidator 


Configuration cfg = ....; 
new SchemaValidator(cfg). ‘validate(); 


20.1.8. 使 用 Ant 进 行 sSchema 校 验 
你 可 以 在 Ant 脚 本 中 调用 Schemavalidator : 


<target name="Schemavalidate"> 
<taskdef name="schemavalidator" 
classname="org.hibernate.tool.hbm2dd1.SchemaValidatorTask" 
classpathref="class.path"/> 


<schemavalidator 
properties="hibernate.properties"> 
<fileset dir="src"> 
<include name="**/*.hbm. xmL"/> 
</fileset> 
</schemaupdate> 
</target> 


| 


第 21 & 示例 : 父子 关系 (Parent Child 
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21.5. 结论 


刚刚 接触 Hibernate 的 人 大 多 是 从 父子 关系 (parent / child type relationship) 的 建 
模 入 手 的 。 父 子 关系 的 建 模 有 两 种 方法 。 由 于 种 种 原因 ， 最 方便 的 方法 是 

把 Parent 和 child 都 建 模 成 实体 类 ， 并 创建 一 个 从 Parent 指向 child 的 
<one-to-many> 关 联 ， 对 新 手 来 说 尤其 如 此 。 还 有 一 种 方法 ， 就 是 将 child 声明 
为 一 个 &lt;composite-element&gt; (WATR) 。 事实 上 在 Hibernate 中 one 
to many 关 联 的 默认 语义 远 没 有 composite element 贴 近 parent / child 关 系 的 通常 语 
义 。 下 面 我 们 会 前 述 如 何 使 用 带 有 级 联 的 双向 一 对 多 关联 (biajrectionalj one to 

many association with cascaaes) 去 建立 有 效 、 优 美的 parent / child 关 系 。 这 一 点 也 
AR xf | 


21.1. 关于 collections 需 要 注意 的 一 点 


Hibernate collections 被 当 作 其 所 属实 体 而 不 是 其 包含 实体 的 一 个 逻辑 部 分 。 这 非常 
重要 ! 它 主 要 体现 为 以 下 几 点 : 


e 当 和 删除 或 增加 collection 中 对 象 的 时 候 ，collection 所 属 者 的 版 本 值 会 递增 。 


e 如 果 一 个 从 collection 中 移 除 的 对 象 是 一 个 值 类 型 (value type) 的 实例 ， 上 比如 
composite element， 那 么 这 个 对 象 的 持久 化 状态 将 会 终止 ， 其 在 数据 库 中 对 应 
的 记录 会 被 删除 。 同 样 的 ， 向 collection 增 加 一 个 value type 的 实例 将 会 使 之 立 
即 被 持久 化 。 


。 另 一 方面 ， 如 果 从 一 对 多 或 多 对 多 关联 的 collection 中 移 除 一 个 实体 ， 在 缺 省 情 
况 下 这 个 对 象 并 不 会 被 删除 。 这 个 行为 是 完全 合乎 巡 辑 的 一 一 改变 一 个 实体 的 
内 部 状态 不 应 该 使 与 它 关 联 的 实体 消失 掉 | 同样 的 ， 向 collection 增 加 一 个 实体 
不 会 使 之 被 持久 化 。 


实际 上 ， 向 Collection 增 加 一 个 实体 的 缺 省 动作 只 是 在 两 个 实体 之 间 创 建 一 个 连接 而 
已 ， 同 样 移 除 的 时 候 也 只 是 删除 连接 。 这 种 处 理 对 于 所 有 的 情况 都 是 合适 的 。 对 于 
父子 关系 则 是 完全 不 适合 的 ， 在 这 种 关系 下 ， 子 对 象 的 生存 绑 定 于 父 对 象 的 生存 周 
期 。 


21.2. 双向 的 一 对 多 关系 (Bidirectional one-to- 
many) 


假设 我 们 要 实现 一 个 简单 的 从 Parent 到 Child 的 <one-to-many> 关 联 。 


<set name="children"> 
<key column="parent_id"/> 
<one-to-many class="Child"/> 
</set> 


如 果 我 们 运行 下 面 的 代码 


Parent p= ..... 
Child c = new Ce 
p. ec add(c); 
session.save(c); 
session.flush(); 


Hibernate 会 产生 两 条 SQL 语句 : 

e 一 条 INSERT 语句 ， 为 c 创建 一 条 记录 

e 一 条 UPDATE 语句 ， 创 建 从 p 到 c 的 连接 
这 样 做 不 仅 效率 低 ， 而 且 违 反 了 列 parent_id 非 空 的 限制 。 我 们 可 以 通过 在 集合 
类 映射 上 指定 not-null="true" 来 解决 违反 非 空 约束 的 问题 : 


<set name="children"> 
<key column="parent_id" not-null="true"/> 
<one-to-many class="Child"/> 

</set> 


然而 ， 这 并 非 是 推荐 的 解决 方法 。 
这 种 现象 的 根本 原因 是 从 p 到 c 的 连接 〈 外 键 parent id) 没有 被 当 作 Child 对 


象 状态 的 一 部 分 ， 因 而 没有 在 INSERT 语 句 中 被 创建 。 因 此 解决 的 办 法 就 是 把 这 个 
连接 添加 到 Child 的 映射 中 。 


<many-to-one name="parent" column="parent_id" not-null="true"/> 


(我 们 还 需要 A, 类 Child 添加 parent 属性 ) 


现在 实体 Child 在 管理 连接 的 状态 ， 为 了 使 collection 不 更 新 连接 ， 我 们 使 
用 inverse 属性 。 


<set name="children" inverse="true"> 
<key column="parent_id"/> 
<one-to-many class="Child"/> 
</set> 


下 面 的 代码 是 用 来 添加 一 个 新 的 Child 


Parent p = (Parent) session.load(Parent.class, pid); 
Child c = new Child(); 

c.setParent(p); 

p.getChildren().add(c); 

session.save(c); 

session.flush(); 


现在 ， 只 会 有 一 条 INSERT 语句 被 执行 ! 


为 了 让 事情 变 得 井井有条 ， 可 以 为 Parent 加 一 个 addchild() 方法 。 


public void addChild(Child c) { 
c.setParent(this); 
children.add(c); 


现在 ， 添 加 Child 的 代码 就 是 这 样 


Parent p = (Parent) session.load(Parent.class, pid); 
Child c = new Child(); 

p.addChild(c); 

session.save(c); 

session.flush(); 


21.3. 级 联 生命 周期 (Cascading lifecycle) 


需要 显 式 调用 save() 仍然 很 有 麻烦， 我们 可 以 用 级 联 来 解决 这 个 问题 。 


<Set name="children" inverse="true" cascade="all"> 
<key column="parent_id"/> 
<one-to-many class="Child"/> 

</set> 


这 样 上 面 的 代码 可 以 简化 为 : 


Parent p = (Parent) session.load(Parent.class, pid); 
Child c = new Child(); 

p.addChild(c); 

session.flush(); 


同样 的 ， 保 存 或 删除 Parent 对 象 的 时 候 并 不 需要 通 历 其 子 对 象 。 
删除 对 象 p 及 其 所 有 子 对 象 对 应 的 数据 库 记录 。 


Parent p = (Parent) session.load(Parent.class, pid); 
session.delete(p); 
session.flush(); 


然而 ， 这 段 代 码 


Parent p = (Parent) session.load(Parent.class, pid); 
Child c = (Child) p.getChildren().iterator().next(); 
p.getChildren().remove(c); 

c.setParent(null); 

session.flush(); 


下 面 的 代码 会 


不 会 从 数据 库 删 除 c ; 它 只 会 删除 与 p 之 间 的 连接 (并 且 会 导致 违 
R NOT NULL 约束 ， 在 这 个 例子 中 ) 。 你 需要 显 式 调 用 delete() 来 删 


除 child 。 


Parent p = (Parent) session.load(Parent.class, pid); 
Child c = (Child) p.getChildren().iterator().next(); 
p.getChildren().remove(c); 

session.delete(c); 

session.flush(); 


在 我 们 的 例子 中 ， 如 果 没 有 父 对 象 ， 子 对 象 就 不 应 该 存在 ， 如 果 将 子 对 象 从 
collection 中 移 除 ， 实 际 上 我 们 是 想 删 除 它 。 要 实现 这 种 要 求 ， 就 必须 使 


用 cascade="all-delete-orphan" 。 


<set name="children" inverse="true" cascade="all-delete-orphan"> 
<key column="parent_id"/> 
<one-to-many class="Child"/> 

</set> 


注意 : 即使 在 collection 一 方 的 映射 中 指定 inverse="true" ， 级 联 仍然 是 通过 通 
历 collection 中 的 元 素来 处 理 的 。 如 果 你 想 要 通过 级 联 进行 子 对 象 的 插 和 入、 删除、 更 
新 操作 ， 就 必须 把 它 加 到 collection 中 ， 只 调用 setParent() 是 不 够 的 。 


21.4. 级 联 与 未 保存 值 (Cascades and 
unsaved-value ) 


eee eee es eg 用 户 界 面 对 其 进行 了 修改 ， 然 

望 在 一 个 新 的 Session 里 面 调用 update() 来 保存 这 些 修改 。 对 象 Parent 包 
Pu ， 由 于 打开 了 级 联 更 新 ，Hibernate 需 要 知道 哪些 Child 对 象 是 新 
实例 化 的 ， 哪 些 代 表 数 据 库 中 已 经 存在 的 记录 。 我 们 假设 Parent 和 Child WR 
的 标识 属性 都 是 自动 生成 的 ， 类 型 为 java.1ang.Long 。Hibernate 会 使 用 标识 属 
性 的 值 ， 和 version 或 timestamp 属性 ， 来 判断 哪些 子 对 象 是 新 的 。 (人 
节 “自动 状态 检测 ”.) 在 Hibernate3 中 , 显 式 指定 unsaved-value 不 再 是 必须 的 
To 


下 面 的 代码 会 更 新 parent 和 child 对 象 ， 并 且 插 入 newchild 对 象 。 


//parent and child were both loaded in a previous session 
parent.addChild(child); 

Child newChild = new Child(); 

parent.addChild(newChild) ; 

session.update(parent); 

session.flush(); 


Well, that's all very well for the case of a generated identifier, but what about 
assigned identifiers and composite identifiers? This is more difficult, since 
Hibernate can't use the identifier property to distinguish between a newly 
instantiated object (with an identifier assigned by the user) and an object loaded in 
a previous session. In this case, Hibernate will either use the timestamp or version 
property, or will actually query the second-level cache or, worst case, the 
database, to see if the row exists. 


这 对 于 自动 生成 标识 的 情况 是 非常 好 的 ， 但 是 自分 配 的 标识 和 复合 标识 怎么 ae? 
这 是 有 点 麻烦 ， 因 为 Hibernate 没 有 办 法 区 分 新 实例 化 的 对 象 (标识 被 用 户 指 定 了 ) 
和 前 一 个 Session 装 入 的 对 象 。 在 这 种 情况 下 ，Hibernate 会 使 用 timestamp 或 
oe 或 者 查询 第 二 级 缓存 ， 或 者 最 坏 的 情况 ， 查 询 数据 库 ， 来 确认 是 否 此 
行 存在。 


21.5. 结论 


这 里 有 不 少 东 西 需要 融会 员 通 ， 可 能 会 让 新 手感 到 迷惑 。 但 是 在 实践 中 它们 都 工作 
地 非常 好 。 大 部 分 Hibernate 应 用 程序 都 会 经 常用 到 父子 对 象 模 式 。 


在 第 一 段 中 我 们 佛经 提 到 另 一 个 方案 。 上 面 的 这 些 问 题 都 不 会 出 现 

在 &lt;composite-elementagt; 了 映射 中 ， 它 准确 地 表达 了 父子 关系 的 语义 。 很 
不 幸 复 合 元 素 还 有 两 个 重大 限制 :复合 元 素 不 能 拥有 collections， 并 且 ， 除 了 用 于 改 
一 的 父 对 象 外 ， 它 们 不 能 再 作为 其 它 任何 实体 的 子 对 象 。 


第 22 章 示例 : Weblog 应 用 程序 


目录 


e 22.1. 持久 化 类 
e 22.2. Hibernate 映射 
e 22.3. Hibernate 代码 


22.1. 持久 化 类 


下 面 的 持久 化 类 表示 一 个 weblog 和 在 其 中 张贴 的 一 个 贴 子 。 他 们 是 标准 的 父 / 子 关 
系 模型 ， 但 是 我 们 会 用 一 个 有 序 包 (ordered bag) 而 非 集合 (set)。 


package eg; 
import java.util.List; 


public class Blog { 
private Long _id; 
private String _name; 
private List _items; 


public Long getId() { 
return _id; 


public List getItems() { 
return _items; 


} 
public String getName() { 
return _name; 


public void setId(Long long1) { 
_id = longi; 


public void setItems(List list) { 
_items = list; 


public void setName(String string) { 
_name = string; 
} 


package eg; 


import java.text.DateFormat; 
import java.util.Calendar; 


public class BlogItem { 
private Long _id; 
private Calendar _datetime; 
private String _text; 
private String _title; 
private Blog _blog; 


public Blog getBlog() { 
return _blog; 


public Calendar getDatetime() { 
return _datetime; 


} 
public Long getId() { 


return _id; 
} 


public String getText() { 
return _text,; 


public String getTitle() { 
return _title; 


} 
public void setBlog(Blog blog) { 
_blog = blog; 


public void setDatetime(Calendar calendar) { 
_datetime = calendar; 


public void setId(Long long1) { 
_id = longi; 


public void setText(String string) { 
_text = string; 


public void setTitle(String string) { 
_title = string; 


} 


22.2. Hibernate 映射 
下 列 的 XML 映射 应该 是 很 直 白 的 。 


<?xml version="1.0"?> 

<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dt¢ 


<hibernate-mapping package="eg"> 
<class 
name="Blog" 
table="BLOGS" > 


<id 
name="id" 
column="BLOG_ID"> 


<generator class="native"/> 
</id> 


<property 
name="name" 
column="NAME" 
not-null="true" 
unique="true"/> 


<bag 
name="items" 
inverse="true" 
order -by="DATE_TIME" 
cascade="all"> 


<key column="BLOG_ID"/> 
<one-to-many class="BlogItem"/> 


</bag> 


</class> 


</hibernate-mapping> 





<?xml version="1.0"?> 

<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dt¢ 


<hibernate-mapping package="eg"> 


<class 
name="BlogItem" 
table="BLOG_ITEMS" 
dynamic -update="true"> 


<id 
name="id" 
column="BLOG_ITEM_ID"> 


<generator class="native"/> 
</id> 


<property 
name="title" 
column="TITLE" 
not-null="true"/> 


<property 
name="text" 
column="TEXT" 
not-null="true"/> 


<property 
name="datetime" 
column="DATE_TIME" 
not-null="true"/> 


<many -to-one 
name="blog" 
column="BLOG_ID" 
not-null="true"/> 
</class> 


</hibernate-mapping> 


I 





22.3. Hibernate 代码 
下 面 的 类 演示 了 我 们 可 以 使 用 Hibernate 对 这 些 类 进行 的 一 些 操作 。 


package eg; 


import java.util.ArrayList; 
import java.util.Calendar; 
import java.util.Iterator; 
import java.util.List; 


import org.hibernate.HibernateException; 

import org.hibernate. Query; 

import org.hibernate.Session; 

import org.hibernate.SessionFactory; 

import org.hibernate.Transaction; 

import org.hibernate.cfg.Configuration; 

import org.hibernate.tool.hbm2dd1.SchemaExport; 


public class BlogMain { 
private SessionFactory _sessions; 


public void configure() throws HibernateException { 
_sessions = new Configuration() 
.addClass(Blog.class) 
.addClass(BlogItem.class) 
.buildSessionFactory(); 


} 


public void exportTables() throws HibernateException { 
Configuration cfg = new Configuration() 
.addClass(Blog.class) 
.addClass(BlogItem.class); 
new SchemaExport(cfg).create(true, true); 


} 
public Blog createBlog(String name) throws HibernateException : 
Blog blog = new Blog(); 


blog.setName(name); 
blog.setItems( new ArrayList() ); 


Session session = _sessions.openSession(); 
Transaction tx = null; 
try { 


tx = session.beginTransaction(); 
session.persist(blog); 
tx.commit(); 


catch (HibernateException he) { 
if (tx!=null) tx.rollback(); 


throw he; 
} 
finally { 
session.close(); 
} 


return blog; 


} 


public BlogItem createBlogItem(Blog blog, String title, String 
throws HibernateException { 


BlogItem item = new BlogItem(); 

item. setTitle(title); 

item. setText(text); 

item.setBlog(blog); 

item.setDatetime( Calendar.getInstance() ); 
blog.getItems().add(item); 


Session session = _sessions.openSession(); 
Transaction tx = null; 
try { 


tx = session.beginTransaction(); 
session.update(blog); 
tx.commit(); 


catch (HibernateException he) { 
if (tx!=null) tx.rollback(); 


throw he; 
} 
finally { 
session.close(); 
} 


return item; 


} 


public BlogItem createBlogItem(Long blogid, String title, Strir 
throws HibernateException { 


BlogItem item = new BlogItem(); 
item.setTitle(title); 

item. setText (text); 

item.setDatetime( Calendar.getInstance() ); 


Session session = _sessions.openSession(); 
Transaction tx = null; 
try { 


tx = session.beginTransaction(); 

Blog blog = (Blog) session.load(Blog.class, blogid); 
item.setBlog(blog); 

blog.getItems().add(item) ; 


tx.commit(); 


} 


catch (HibernateException he) { 
if (tx!=null) tx.rollback(); 


throw he; 
} 
finally { 
session.close(); 
} 


return item; 


} 


public void updateBlogItem(BlogItem item, String text) 
throws HibernateException { 


item.setText(text); 


Session session = _sessions.openSession(); 
Transaction tx = null; 
try { 


tx = session.beginTransaction(); 
session.update(item) ; 
tx.commit(); 


catch (HibernateException he) { 
if (tx!=null) tx.rollback(); 


throw he; 
} 
finally { 
session.close(); 
} 


} 


public void updateBlogItem(Long itemid, String text) 
throws HibernateException { 


Session session = _sessions.openSession(); 
Transaction tx = null; 
try { 


tx = session.beginTransaction(); 

BlogItem item = (BlogItem) session.load(BlogItem.class, 
item. setText(text); 

tx.commit(); 


catch (HibernateException he) { 
if (tx!=null) tx.rollback(); 


throw he; 
} 
finally { 
session.close(); 
} 


public List listAl1BlogNamesAndItemCounts(int max) 
throws HibernateException { 


Session session = _sessions.openSession(); 
Transaction tx = null; 
List result = null; 
try { 
tx = session.beginTransaction(); 
Query q = session.createQuery( 
"select blog.id, blog.name, count(blogItem) " + 
"from Blog as blog " + 
"left outer join blog.items as blogItem " + 
"group by blog.name, blog.id " + 
"order by max(blogItem.datetime)" 
); 
q.setMaxResults(max); 
result = q.list(); 
tx.commit(); 


catch (HibernateException he) { 
if (tx!=null) tx.rollback(); 


throw he; 
} 
finally { 
session.close(); 
} 


return result; 


} 


public Blog getBlogAndAlliItems(Long blogid) 
throws HibernateException { 


Session session = _sessions.openSession(); 
Transaction tx = null; 
Blog blog = null; 
try { 
tx = session.beginTransaction(); 
Query q = session.createQuery( 
"from Blog as blog " + 
"left outer join fetch blog.items " + 
"where blog.id = :blogid" 
); 
q.setParameter("blogid", blogid); 
blog = (Blog) q.uniqueResult(); 
tx.commit(); 


catch (HibernateException he) { 
if (tx!=null) tx.rollback(); 
throw he; 

} 

finally { 
session.close(); 


} 


return blog; 


} 


public List listBlogsAndRecentItems() throws HibernateExceptior 


Session session = _sessions.openSession(); 
Transaction tx = null; 
List result = null; 
try { 
tx = session.beginTransaction(); 
Query q = session.createQuery( 
"from Blog as blog " + 
"inner join blog.items as blogItem " + 
"where blogItem.datetime > :minDate" 


); 


Calendar cal = Calendar.getInstance(); 
cal.roll(Calendar.MONTH, false); 
q.setCalendar("minDate", cal); 


result = q.list(); 
tx.commit(); 


catch (HibernateException he) { 
if (tx!=null) tx.rollback(); 


throw he; 
} 
finally { 
session.close(); 
} 


return result; 





第 23 章 示例 : 复 灯 映射 实例 


e 23.1. Employer (#+)/Employee(E i ) 
e 23.2. Author( 作 家 )/Work( 作 品 ) 
e 23.3. Customer( 客 户 )/Order( 订 单 MProduct( 产 品 ) 
e 23.4. 条 例 
o 23.4.1. "Typed" one-to-one association 
o 23.4.2. Composite key example 
o 23.4.3. 共有 组 合 键 属性 的 多 对 多 (Many-to-many with shared composite 
key attribute) 
o 23.4.4. Content based discrimination 
o 23.4.5. Associations on alternate keys 


本 章 展示 了 一 些 较为 复杂 的 关系 映射 。 


23.1. Employer (/2=)/Employee(# ñ ) 


下 面 关 于 Employer 和 Employee 的 关系 模型 使 用 了 一 个 真实 的 实体 类 
( Employment ) 来 表述 ， 这 是 因为 对 于 相同 的 展 员 和 履 主 可 能 会 有 多 个 懂 佣 时 间 
对 于 金额 和 懂 员 姓名 ， 用 Components 建 模 。 


段 。 










Employment 
-startDate : Date 
-endDate : Date 
-id : long 
+getStartDated : Date 
+setStartDatetstartDate:Date) 
+getEndDated : Date 
+setEndDateLendDate:Date) 
+getHourlyRated : MonetoryAmount 
+setHourlyRatetrate:MonetoryAmount) 
+getldd : long 

+setidLid:long) 

+getEmployerd : Employer 
+setEmployertemp:Employen 


Employer 
-id : long 
-name : String 
二 getldo : long 
+setldLid:long) 
+getNamed : String 
+setName(_namesString) 



















十 employer 0..* 





+getEmployeed : Employee 





+setEmployeelemp:Employee) 





映射 文件 可 能 是 这 样 : 


并 


十 employee 










十 hourlyRat 













Employee 





-id : long 
-taxfileNumber : String 











+getNamed : Name 
+setNameiname:Name) 

+getldù : long 

+setldLid:long) 

+getTaxfileNumberd : String 
+setTaxfileNumber(taxfileNumbersString) 
















MonetoryAmount 





-amount : BigDecimal 
-currency : Currency 





+getAmountd : BigDecimal 
+setAmountL_amount:BigDecimal 


+qgetCurrencyd : Currency 
+setCurrencycurrency:Currency) 








-firstName : String 
name] -initial : char 
-lastName : String 
+getFirstNamed : String 
+setFirstName(_firstName String) 
+getinitiald : char 
+setinitialLinitial:chan 
+getLastNamed : String 
+setLastName(lastName:String) 


















<hibernate-mapping> 


<class name="Employer" table="employers"> 
<id name="id"> 
<generator class="Ssequence"> 
<param name="Sequence">employer_id_seq</param> 
</generator> 
</id> 
<property name="name"/> 
</class> 


<class name="Employment" table="employment_periods"> 


<id name="id"> 
<generator class="sequence"> 
<param name="Sequence">employment_id_seq</param> 
</generator> 
</id> 
<property name="StartDate" column="start_date"/> 
<property name="endDate" column="end_date"/> 


<component name="hourlyRate" class="MonetaryAmount"> 
<property name="amount"> 
<column name="hourly_rate" sql-type="NUMERIC(12, 2° 
</property> 
<property name="Ccurrency" length="12"/> 
</component> 


<many-to-one name="employer" column="employer_id" not-null: 
<many-to-one name="employee" column="employee_id" not-null: 


</class> 


<class name="Employee" table="employees"> 
<id name="id"> 
<generator class="Ssequence"> 
<param name="Sequence">employee_id_seq</param> 
</generator> 
</id> 
<property name="taxfileNumber"/> 
<component name="name" class="Name"> 
<property name="firstName"/> 
<property name="initial"/> 
<property name="lastName"/> 
</component> 
</class> 


</hibernate-mapping> 


«| Da 








用 SchemaExport 生成 表 结 构 。 


create table employers ( 
id BIGINT not null, 
name VARCHAR( 255), 
primary key (id) 

) 


create table employment_periods ( 
id BIGINT not null, 
hourly_rate NUMERIC(12, 2), 
currency VARCHAR(12), 
employee_id BIGINT not null, 
employer_id BIGINT not null, 
end_date TIMESTAMP, 
start_date TIMESTAMP, 
primary key (id) 

) 


create table employees ( 
id BIGINT not null, 
firstName VARCHAR( 255), 
initial CHAR(1), 
lastName VARCHAR(255), 
taxfileNumber VARCHAR( 255), 
primary key (id) 

) 


alter table employment_periods 

add constraint employment_periodsFKO foreign key (employer_id) 
alter table employment_periods 

add constraint employment_periodsFK1i foreign key (employee_id) 
create sequence employee_id_seq 
create sequence employment_id_seq 
create sequence employer_id_seq 


PD 





23.2. Author( 作 家 )/Work( 作 品 ) 


考虑 下 面 的 work , Author 和 Person 模型 的 关系 。 我 们 用 多 对 多 关系 来 描 
yk work 和 Author ， 用 一 对 一 关系 来 描述 Author 和 Person, 另 一 种 可 
能 性 是 Author 继承 Person 。 















-id : long -id : long -id : long 
-title : String ” “| -alias : String -name : String 


+getldd : long d+getldù : long +getldd : long 
+setldLid:long) +setldLid:long) +setldLid:long) 
+getAuthorsd : Set +getorks0 : Set +getNamed : String 
+setAuthorslemployees:Set) +setWorkslemployers:Set) +setNametname:String) 
+qgetTitled : String +qgetPersond : Person 
+setTitletitle:String) +setPersoniperson:Persom 

+qgetAliasd : String 

+setAliasalias‘String) 













Book 


| Sm [tok | 


-tempo : float 
+getGenred : String 
+setGenre(genre String) 


+getTempood : float 
+setTempoltempo:float) 


+getTextd : int 
+setTextLtext:int) 


下 面 的 映射 文件 正确 的 描述 了 这 些 关系 : 


<hibernate-mapping> 
<class name="Work" table="works" discriminator-value="W"> 


<id name="id" column="id"> 
<generator class="native"/> 
</id> 
<discriminator column="type" type="character"/> 


<property name="title"/> 
<set name="authors" table="author_work"> 

<key column name="work_id"/> 

<many-to-many class="Author" column name="author_id"/> 
</set> 


<subclass name="Book" discriminator -value="B"> 
<property name="text"/> 
</subclass> 


<subclass name="Song" discriminator -value="S"> 
<property name="tempo"/> 
<property name="genre"/> 


</subclass> 
</class> 
<class name="Author" table="authors"> 


<id name="id" column="id"> 


<!-- The Author must have the same identifier as the Pt 
<generator class="assigned"/> 
</id> 


<property name="alias"/> 
<one-to-one name="person" constrained="true"/> 


<set name="works" table="author_work" inverse="true"> 
<key column="author_id"/> 


<many-to-many class="Work" column="work_id"/> 
</set> 


</class> 


<class name="Person" table="persons"> 
<id name="id" column="id"> 
<generator class="native"/> 
</id> 
<property name="name"/> 
</class> 


</hibernate-mapping> 


ls 一 一 一 





映射 中 有 4 个 表 。 works, authors 和 persons 分 别 保存 着 work，author 和 
person 的 数据 。 author_work 是 authors 和 works 的 关联 表 。 表 结 构 是 
由 SchemaExport 生成 的 。 


create table works ( 
id BIGINT not null generated by default as identity, 
tempo FLOAT, 
genre VARCHAR( 255), 
text INTEGER, 
title VARCHAR(255), 
type CHAR(1) not null, 
primary key (id) 
) 


create table author_work ( 
author_id BIGINT not null, 
work_id BIGINT not null, 
primary key (work_id, author_id) 


) 


create table authors ( 
id BIGINT not null generated by default as identity, 
alias VARCHAR(255), 
primary key (id) 

) 


create table persons ( 
id BIGINT not null generated by default as identity, 
name VARCHAR( 255), 
primary key (id) 

) 


alter table authors 

add constraint authorsFKO foreign key (id) references persons 
alter table author_work 

add constraint author_workFKO foreign key (author_id) reference 
alter table author_work 

add constraint author_workFK1 foreign key (work_id) references 





23.3. Customer( 客 户 )/Order( 订 单 MProduct( 产 品 ) 


现在 来 考虑 Customer , Order , 


LineItem 和 Product 关系 的 模 


型 。 Customer 和 Order 之 间 是 一 对 多 的 关系 ， 但 是 我 们 怎么 来 描述 order / 
LineItem / Product E? 我 可 以 把 LineItem 作为 描述 Order 和 
Product 多 对 多 关系 的 关联 类 ， 在 Hibernate， 这 叫做 组 合 元 素 。 


十 5etldLid:long) 
+getNamed : String 
+setNamelname:String) 
+getOrdersd : Set 
+setOrderstorders:Set) 








映射 文件 如 下 : 

















Lineltem 





Product 

















Customer Order 
-id : long 0. -id : long 
-name : String +customer +orders |-date : Date 
+getidd : long +qgetidd : long 


+setldLid:long) 

+getLineltemsd : List 
+setLineltemstlineltems:List) 
+getCustomerd : Customer 
+setCustomer(customer:Customen 
+getDated : Date 
+setDate(_date:Date) 









+setQuantityquantity:int) 
+getProductd : Product 
+setProduct(product:Product) 


-id: long 
-serialNumber : String 





+getldd : long 

+setldLid:long) 

+getSerialNumberd : String 
+setSerialNumber(_serialNumberString) 





<hibernate-mapping> 


<class name="Customer" table="Ccustomers"> 
<id name="id"> 
<generator class="native"/> 
</id> 
<property name="name"/> 
<set name="orders" inverse="true"> 
<key column="Customer_id"/> 
<one-to-many class="Order"/> 
</set> 
</class> 


<class name="Order" table="orders"> 
<id name="id"> 
<generator class="native"/> 
</id> 
<property name="date"/> 
<many-to-one name="Customer" column="Customer_id"/> 
<list name="lineItems" table="line_items"> 
<key column="order_id"/> 
<list-index column="line_number"/> 
<composite-element class="LineItem"> 
<property name="quantity"/> 
<many-to-one name="product" column="product_id"/> 
</composite-element> 
</list> 
</class> 


<class name="Product" table="products"> 
<id name="id"> 
<generator class="native"/> 
</id> 
<property name="SserialNumber"/> 
</class> 


</hibernate-mapping> 
[RE 


customers , orders , line_items 和 products 分 别 保存 着 customer, 
order, order line item 和 product 的 数据 。 1Line_items 也 作为 连接 orders 和 
products 的 关联 表 。 


create table customers ( 
id BIGINT not null generated by default as identity, 
name VARCHAR( 255), 
primary key (id) 

) 


create table orders ( 
id BIGINT not null generated by default as identity, 
customer_id BIGINT, 
date TIMESTAMP, 
primary key (id) 
) 


create table line_items ( 
line_number INTEGER not null, 
order_id BIGINT not null, 
product_id BIGINT, 
quantity INTEGER, 
primary key (order_id, line_number ) 


) 


create table products ( 
id BIGINT not null generated by default as identity, 
serialNumber VARCHAR(255), 
primary key (id) 

) 


alter table orders 

add constraint ordersFKO foreign key (customer_id) references ( 
alter table line_items 

add constraint line_itemsFKO foreign key (product_id) reference 
alter table line_items 

add constraint line_itemsFK1 foreign key (order_id) references 


BEEE] 





23.4. 2 fill 


这 些 例子 全 部 来 自 于 Hibernate 的 test suite， 同 时 你 也 可 以 找到 其 他 有 用 的 例子 。 
可 以 参考 Hibernate 的 test 目录 。 


TODO: put words around this stuff 


23.4.1. "Typed" one-to-one association 


<class name="Person"> 
<id name="name"/> 
<one-to-one name="address" 
cascade="all"> 
<formula>name</formula> 
<formula>'HOME'</formula> 
</one-to-one> 
<one-to-one name="mailingAddress" 
cascade="all"> 
<formula>name</formula> 
<formula>'MAILING'</formula> 
</one-to-one> 
</class> 


<class name="Address" batch-size="2" 


check="addressType in ('MAILING', 'HOME', 'BUSINESS')"> 


<composite-id> 
<key-many-to-one name="person" 
column="personName"/> 
<key-property name="type" 
column="addressType"/> 
</composite-id> 
<property name="Street" type="text"/> 
<property name="Sstate"/> 
<property name="zip"/> 
</class> 


23.4.2. Composite key example 


<class name="Customer"> 


<id name="customerId" 
length="10"> 
<generator class="assigned"/> 
</id> 


<property name="name" not-null="true" length="100"/> 
<property name="address" not-null="true" length="200"/> 


<list name="orders" 
inverse="true" 
cascade="Save-update"> 
<key column="customerId"/> 
<index column="orderNumber"/> 
<one-to-many class="Order"/> 
</list> 


</class> 


<class name="Order" table="CustomerOrder" lazy="true"> 
<synchronize table="LineItem"/> 
<synchronize table="Product"/> 


<composite-id name="id" 
class="Order$Id"> 
<key-property name="customerId" length="10"/> 
<key-property name="orderNumber"/> 
</composite-id> 


<property name="orderDate" 
type="calendar_date" 
not -null="true"/> 


<property name="total"> 
<formula> 
( select sum(1i.quantity*p.price) 
from LineItem li, Product p 
where 1i.productId = p.productId 
and 1i.customerId = customerId 
and 1i.orderNumber = orderNumber ) 
</formula> 
</property> 


<many-to-one name="Customer" 
column="customertId" 
insert="false" 


update="false" 
not-null="true"/> 


<bag name="lineItems" 
fetch="join" 
inverse="true" 
cascade="Save-update"> 
<key> 
<column name="customerId"/> 
<column name="orderNumber"/> 
</key> 
<one-to-many class="LineItem"/> 
</bag> 


</class> 


<class name="LineItem"> 


<composite-id name="id" 
class="LineItem$Id"> 
<key-property name="CcustomerId" length="10"/> 
<key-property name="orderNumber"/> 
<key-property name="productId" length="10"/> 


</composite-id> 
<property name="quantity"/> 


<many-to-one name="order" 
insert="false" 
update="false" 
not-null="true"> 
<column name="customerId"/> 
<column name="orderNumber"/> 
</many - to-one> 


<many-to-one name="product" 
insert="false" 
update="false" 
not -null="true" 
column="productIid"/> 


</class> 


<class name="Product"> 
<synchronize table="LineItem"/> 


<id name="productId" 

length="10"> 

<generator class="assigned"/> 
</id> 


<property name="description" 
not-null="true" 


length="200"/> 
<property name="price" length="3"/> 
<property name="numberAvailable"/> 


<property name="numberOrdered"> 
<formula> 
( select sum(1li.quantity) 
from LineItem li 
where 1li.productId = productId ) 
</formula> 
</property> 


</class> 


23.4.3. 共有 组 合 键 属性 的 多 对 多 (Many-to-many 
with shared composite key attribute) 


<class name="User" table=" User "> 
<composite-id> 
<key-property name="name"/> 
<key-property name="org"/> 
</composite-id> 
<set name="groups" table="UserGroup"> 
<key> 
<column name="userName"/> 
<column name="org"/> 
</key> 
<many-to-many class="Group"> 
<column name="groupName"/> 
<formula>org</formula> 
</many - to-many> 
</set> 
</class> 


<class name="Group" table=" Group "> 
<composite-id> 
<key-property name="name"/> 
<key-property name="org"/> 
</composite-id> 
<property name="description"/> 
<set name="users" table="UserGroup" inverse="true"> 
<key> 
<column name="groupName"/> 
<column name="org"/> 
</key> 
<many-to-many class="User"> 
<column name="userName"/> 
<formula>org</formula> 
</many - to-many> 
</set> 
</class> 


23.4.4. Content based discrimination 


<class name="Person" 
discriminator -value="P"> 


<id name="id" 
column="person_id" 
unsaved -value="0"> 
<generator class="native"/> 


</id> 
<discriminator 
type="character"> 
<formula> 
case 
when title is not null then 'E' 
when salesperson is not null then 'C' 
else 'P' 
end 
</formula> 
</discriminator> 


<property name="name" 
not-null="true" 
length="80"/> 


<property name="sex" 
not-null="true" 
update="false"/> 


<component name="address"> 
<property name="address"/> 
<property name="zip"/> 
<property name="country"/> 
</component> 


<subclass name="Employee" 
discriminator -value="E"> 
<property name="title" 
length="20"/> 
<property name="Salary"/> 
<many-to-one name="manager"/> 
</subclass> 


<subclass name="Customer" 
discriminator -value="C"> 
<property name="comments"/> 
<many-to-one name="Salesperson"/> 
</subclass> 


</class> 


23.4.5. Associations on alternate keys 


<class name="Person"> 


<id name="id"> 
<generator class="hilo"/> 
</id> 


<property name="name" length="100"/> 


<one-to-one name="address" 
property-ref="person" 
cascade="all" 
fetch="join"/> 


<set name="accounts" 
inverse="true"> 
<key column="userId" 
property-ref="userId"/> 
<one-to-many class="Account"/> 
</set> 


<property name="userId" length="8"/> 
</class> 
<class name="Address"> 
<id name="id"> 
<generator class="hilo"/> 
</id> 
<property name="address" length="300"/> 
<property name="Zzip" length="5"/> 
<property name="country" length="25"/> 
<many-to-one name="person" unique="true" not-null="true"/> 
</class> 
<class name="Account"> 
<id name="accountId" length="32"> 
<generator class="uuid"/> 
</id> 
<many-to-one name="user" 
column="userId" 
property-ref="userId"/> 


<property name="type" not-null="true"/> 


</class> 


第 24 章 最 佳 实践 (Best Practices) 


设计 细 颗 粒度 的 持久 类 并 且 使 用 &1t;component&gt; 来 实现 映射 。 


使 用 一 个 Address 持久 类 来 封装 street ，suburb ，state , postcode .这 
将 有 利于 代码 重用 和 简化 代码 重 构 (refactoring) 的 工作 。 


对 持久 类 声明 标识 符 属性 ( identifier properties)。 


Hibernate 中 标识 符 属性 是 可 选 的， 不 过 有 很 多 原因 来 说 明 你 应 该 使 用 标识 符 属 性 。 
我 们 建议 标识 符 应 该 是 "人 造 " 的 (自动 生成 ， 不 涉及 业务 含义 )。 


使 用 自然 键 (natural keys) 标 识 


对 所 有 的 实体 都 标识 出 自然 键 ， 用 &1lt;natural-id&gt; 进行 映射 。 实 
现 equals() 和 hashCode() ， 人 在 其 中 用 组 成 自然 键 的 属性 进行 比较 。 


为 每 个 持久 类 写 一 个 映射 文件 


不 要 把 所 有 的 持久 类 映射 都 写 到 一 个 大 文件 中 。 把 com.eg.Foo 映射 
到 com/eg/Foo.hbm.xml 中 ， 在 团队 开发 环境 中 ， 这 一 点 显得 特别 有 意义 。 


把 映射 文件 作为 资源 加 载 
把 映射 文件 和 他 们 的 映射 类 放 在 一 起 进行 部 署 。 
考虑 把 查询 字符 串 放 在 程序 外 面 


如 果 你 的 查询 中 调用 了 非 ANSI 标 准 的 SQL 辑 数 ， 那 么 这 条 实践 经 验 对 你 适用 。 把 查 
询 字符 串 放 在 映射 文件 中 可 以 让 程序 具有 更 好 的 可 移植 性 。 


使 用 绑 定 变量 


就 像 在 JDBC 编 程 中 一 样 ， 应 该 总 是 用 占 位 符 "?" 来 替换 非常 量 值 ， 不 要 在 查询 中 用 
字符 串 值 来 构造 非常 量 值 ! 更 好 的 办 法 是 在 查询 中 使 用 命名 参数 。 

不 要 自己 来 管理 JDBC connections 

Hibernate 人 允许 应 用 程序 自己 来 管理 JDBC connections， 但 是 应 该 作为 最 后 没有 办 

法 的 办 法 。 如 果 你 不 能 使 用 Hibernate 内 建 的 connections providers， 那 么 考虑 实现 


自己 来 实现 org.hibernate.connection.ConnectionProvider 
考虑 使 用 用 户 自 定义 类 型 (custom type) 


假设 你 有 一 个 Java 类 型 ， 来 自 某 些 类 库 ， 需 要 被 持久 化 ， 但 是 该 类 没有 提供 映射 操 
作 需 要 的 存 取 方 法 。 那 么 你 应 该 考虑 实现 org.hibernate.UserType 接口 。 这 种 
办 法 使 程序 代码 写 起 来 更 加 自如 ， 不 再 需要 考虑 类 与 Hibernate type 之 间 的 相互 转 
换 。 


在 性 能 拍 颈 的 地 方 使 用 硬 编码 的 JDBC 


In performance-critical areas of the system, some kinds of operations might 
benefit from direct JDBC. But please, wait until you know something is a 
bottleneck. And don't assume that direct JDBC is necessarily faster. If you need to 
use direct JDBC, it might be worth opening a Hibernate Session and using that 
JDBC connection. That way you can still use the same transaction strategy and 
underlying connection provider. 在 系统 中 对 性 能 要 求 很 严格 的 一 些 部 分 ， 某 些 操作 
也 许 直接 使 用 JDBC 会 更 好 。 但 是 请 先 确认 这 的 确 是 一 个 瓶颈 ， 并 且 不 要 想当然 认 
为 JDBC 一 定 会 更 快 。 如 果 确 实 需 要 直接 使 用 JDBC， 那 么 最 好 打开 一 个 Hibernate 

Session 然后 从 Session 获得 connection， 按 照 这 种 办 法 你 仍然 可 以 使 用 同样 
的 transaction 策 略 和 底层 的 connection provider。 


理解 Session 清洗 (flushing) 


Session 会 不 时 的 向 数据 库 同步 持久 化 状态 ， 如 果 这 种 操作 进行 的 过 于 频繁 ， 性 能 
会 受到 一 定 的 影响 。 有 时 候 你 可 以 通过 禁止 自动 fushing， 尽 量 最 小 化 非 必要 的 
flushing 操 作 ， 或 者 更 进一步 ， 在 一 个 特定 的 transaction 中 改变 查询 和 其 它 操作 的 顺 
序 。 


在 三 层 结构 中 ， 考 虑 使 用 托管 对 象 (detached object) 


当 使 用 一 个 servlet / session bean 类 型 的 架构 的 时 候 , 你 可 以 把 已 加 载 的 持久 对 象 
在 session bean 层 和 servlet / JSP 层 之 间 来 回 传递 。 使 用 新 的 session 来 为 每 个 请 求 
服务 ， 使 用 Session.merge() 或 者 Session.saveOrUpdate() 来 与 数据 库 同 
步 。 


在 两 层 结 构 中 ， 考 虑 使 用 长 持久 上 下 文 (long persistence contexts). 


为 了 得 到 最 佳 的 可 伸缩 性 ， 数 据 库 事 务 (Database Transaction) 应 该 尽 可 能 的 短 。 
但 是 ， 程 序 常常 需要 实现 长 时 间 运 行 的 “应 用 程序 事务 (Application Transaction)”, 
包含 一 个 从 用 户 的 观点 来 看 的 原子 操作 。 这 个 应 用 程序 事务 可 能 跨越 多 次 从 用 户 请 
求 到 得 到 反馈 的 循环 。 用 脱 管 对 象 (与 session 脱 离 的 对 象 ) 来 实现 应 用 程序 事务 是 常 
见 的 。 或 者 ， 尤 其 在 两 层 结 构 中 ， 把 Hibernate Session 从 JDBC 连 接 中 脱离 开 ， 下 
次 需要 用 的 时 候 再 连接 上 。 绝 不 要 把 一 个 Session 用 在 多 个 应 用 程序 事务 
(Application Transaction) 中 ， 否 则 你 的 数据 可 能 会 过 期 失效 。 


不 要 把 异常 看 成 可 恢复 的 


这 一 点 其 至 比 “ 最 佳 实践 ”还 要 重要 ， 这 是 “ 必 各 常识 ”。 当 异常 发 生 的 时 候 ， 必 须要 回 
Æ Transaction ， 关 闭 Session 。 如 果 你 不 这 样 做 的 话 ，Hibernate 无 法 保证 
内 存 状态 精确 的 反应 持久 状态 。 尤 其 不 要 使 用 Session.load() 来 判断 一 个 给 定 
标识 符 的 对 象 实例 在 数据 库 中 是 否 存 在 ， 应 该 使 用 Session.get() 或 者 进行 一 次 
查询 . 


对 于 关联 优先 考虑 lazy fetching 


说 愤 的 使 用 主动 抓 取 (eager fetching)。 对 于 关联 来 说 ， 若 其 目标 是 无 法 在 第 二 级 缓 
存 中 完全 缓存 所 有 实例 的 类 ， 上 应 该 使 用 代理 (proxies) 与 /或 具有 延迟 加 载 属性 的 集合 
(lazy collections)。 若 目标 是 可 以 被 缓存 的 ， 尤 其 是 缓存 的 命中 率 非常 高 的 情况 下 ， 
应 该 使 用 lazy="false" ， 明 确 的 禁止 掉 eager fetching。 如 果 那 些 特殊 的 确实 适 
合 使 用 join fetch 的 场合 ， 请 在 查询 中 使 用 left join fetch 。 


使 用 open session in view 模式 ， 或 者 执行 严格 的 装配 期 (assemb/y phase) Rig Kiet 
免 再 次 抓 取 数据 带 来 的 问题 


Hibernate 让 开发 者 们 摆脱 了 繁琐 的 Data Transfer Objects (DTO)。 在 传统 的 EJB 结 
构 中 ，DTO 有 双重 作用 : 首先 ， 他 们 解决 了 entity bean 无 法 序列 化 的 问题 ; 其 次 ， 
他 们 隐 合 地 定义 了 一 个 装配 期 ， 在 此 期 间 ， 所 有 在 view 层 需要 用 到 的 数据 ， 都 被 抓 
取 、 集 中 到 了 DTO 中 ， 然 后 控制 才 被 装 到 表示 层 。Hibernate 终 结 了 第 一 个 作用 。 
然而 ， 除 非 你 做 好 了 在 整个 泻 染 过 程 中 都 维护 一 个 打开 的 持久 化 上 下 文 (session) 的 
准备 ， 你 仍然 需要 一 个 装配 期 〈 想 象 一 下 ， 你 的 业务 方法 与 你 的 表示 层 有 严格 的 契 
约 ， 数 据 总 是 被 放置 到 托管 对 象 中 ) 。 这 并 非 是 Hibernate 的 限制 ! 这 是 实现 安全 的 
事务 化 数据 访问 的 基本 需求 。 


考虑 把 Hibernate 代 码 从 业务 逻辑 代码 中 抽象 出 来 


把 Hibernate 的 数据 存 取 代码 隐藏 到 接口 (interface) 的 后 面 ， 组 合 使 用 DAO 和 Thread 
Local Session 模 式 。 通 过 Hibernate 的 UserType ， 你 其 至 可 以 用 硬 编码 的 JDBC 
来 持久 化 那些 本 该 被 Hibernate 持 久 化 的 类 。 (该 建议 更 适用 于 规模 足够 大 应 用 软件 
中 ， 对 于 那些 只 有 5 张 表 的 点 用 程序 并 不 适合 。) 


不 要 用 怪异 的 连接 映射 

多 对 多 连接 用 得 好 的 例子 实际 上 相当 少见 。 大 多 数 时 候 你 在 “连接 表 ” 中 需要 保存 额 
外 的 信息 。 这 种 情况 下 ， 用 两 个 指向 中 介 类 的 一 对 多 的 连接 比较 好 。 实 际 上 ， 我 们 
认为 绝 大 多 数 的 连接 是 一 对 多 和 多 对 一 的 ， 你 应 该 首 愤 使 用 其 它 连 接 风 格 ， 用 之 前 
问 自己 一 句 ， 是 否 真 的 必须 这 人 么 做 。 

偏爱 双向 关联 

单 向 关联 更 加 难于 查询 。 在 大 型 应 用 中 ， 几 乎 所 有 的 关联 必须 在 查询 中 可 以 双向 导 


航 。 


